Flow decomposition#

The flow decomposition module allows to decompose active flows on cross-border relevant network element with contingency (XNEC) based on the ACER methodology. This python interface is based on the java implementation in the PowSyBl ENTSO-E repository.

This simple version of flow decomposition will evolve with the next versions of flow decomposition Java version. Here are the assumptions that we made:

  • XNEC = lines specified by the user

  • zone = country

  • country GSK

  • no HVDC management

Run a flow decomposition#

The general idea of this API is to create a decomposition object. Then, you can define contingencies if necessary. Then, you can define XNE and XNEC. XNEC definition requires pre-defined contingencies. Some pre-defined XNE selection adder functions are available. All the adder functions will be united when running a flow decomposition. Finally, you can run the flow decomposition with some flow decomposition and/or load flow parameters.

To do so, you can use the following methods:

create_decomposition

Creates a flow decomposition objet, which can be used to run a flow decomposition on a network

FlowDecomposition.add_single_element_contingencies

Add a contingency for each element (n N-1 states).

FlowDecomposition.add_multiple_elements_contingency

Add a contingency with multiple elements (1 N-k state).

FlowDecomposition.add_monitored_elements

Add branches to be monitored by the flow decomposition.

FlowDecomposition.add_precontingency_monitored_elements

Add branches to be monitored by the flow decomposition on precontingency state (XNE(s)).

FlowDecomposition.add_postcontingency_monitored_elements

Add branches to be monitored by the flow decomposition on postcontingency state (XNEC(s)).

FlowDecomposition.add_5perc_ptdf_as_monitored_elements

Add branches that have a zone to zone PTDF greater than 5% or that are interconnections to be monitored on a precontingency state (XNE).

FlowDecomposition.add_interconnections_as_monitored_elements

Add branches that are interconnections to be monitored on a precontingency state (XNE).

FlowDecomposition.add_all_branches_as_monitored_elements

Add all branches of the network to be monitored on a precontingency state (XNE).

FlowDecomposition.run

Runs a flow decomposition.

Some enum classes are used in the computer:

Parameters#

The execution of the flowdecomposition can be customized using flowdecomposition parameters.

Parameters

Parameters for a flowdecomposition execution.