NTC Multiedge

NTC Multiedge#

Zonal NTC-clearing algorithm on multi-edge interzonal representations.

API path: apem.unit_based_model.allocation.algorithms.zonal_clearing.zonal_ntc_multiedge

class Zonal_NTC_multiedge(zonal_configuration='zonal_DE3', factor=0.8)[source]#

Bases: PowerFlowModel

Variant of the zonal NTC model that preserves individual cross-zonal lines (no aggregation). Each interzonal line in the nodal network becomes its own edge in a zonal MultiGraph so parallel connections are modeled independently. Works only with PyPSA data.

Initialize the multiedge zonal NTC model.

Parameters:

  • zonal_configuration (str) – Name of the zonal configuration used to map nodes to zones.

  • factor (float) – Scaling factor applied to every preserved cross-zonal transfer capacity.

create_zonal_scenario_NTC(base_scenario, results_root=None)[source]#

Convert a nodal scenario into a zonal one while keeping every cross-zonal line as a separate edge.

Parameters:

  • base_scenario (Scenario) – Original nodal scenario to aggregate.

  • results_root (str | None) – Optional directory where the node-to-zone mapping CSV is written.

Returns:

Zonal scenario whose network keeps individual interzonal edges in a MultiGraph.

Return type:

Scenario

solve(
scenario,
configuration,
results_file=None,
stats_file=None,
u_fixed=None,
)[source]#

Create the multiedge zonal scenario and solve the resulting DCOPF problem.

Parameters:

  • scenario (Scenario) – Original nodal scenario to convert and solve.

  • configuration (SolverConfiguration) – Optimizer configuration applied to the zonal DCOPF solve.

  • results_file (str | None) – Optional CSV file path for writing optimization results.

  • stats_file (str | None) – Optional file path for writing allocation statistics.

  • u_fixed (dict | None) – Unused placeholder kept for interface compatibility with other power-flow models.

Returns:

Tuple (zonal_scenario, allocation_or_error).

Return type:

Tuple[Scenario, Allocation | Error]