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:

ContingencyContextType

Parameters¶

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

Parameters

Parameters for a flowdecomposition execution.

pypowsybl.glsk.GLSKDocument.get_glsk_factors pypowsybl.flowdecomposition.create_decomposition