Package com.powsybl.cgmes.conversion

Class SubstationIdMapping

java.lang.Object
com.powsybl.cgmes.conversion.SubstationIdMapping
public class SubstationIdMapping extends Object
CGMES standard:
A PowerTransformer is contained in one Substation, but it can connect a Terminal to another different Substation
A Switch can connect to different voltageLevels

IIDM Model:
Ends of transformers need to be in the same substation
Ends of switches need to be in the same voltageLevel

Solution:
CGMES substations that are connected by transformers will be mapped to a single IIDM substation
CGMES voltageLevels that are connected by switches will be mapped to a single IIDM voltageLevel

Example:
We suppose that VL1, VL2, VL3, VL4, VL5, VL6 and VL7 are CGMES voltageLevels,
Sw23 is a switch connecting voltageLevels VL2 and VL3,
Sw34 is a switch connecting voltageLevels VL3 and VL4 and
Sw67 is a switch connecting voltageLevels VL6 and VL7

Steps:
Fill voltageLevelAdjacency Map
Two voltageLevels are adjacent if they are connected by a switch
The voltageLevelAdjacency Map will include the following records
(VL1, [])
(VL2, [VL2, VL3])
(VL3, [VL2, VL3, VL4])
(VL4, [VL3, VL4])
(VL5, [])
(VL6, [VL6, VL7])
(VL7, [VL6, VL7])

For each non-visited VoltageLevel-key of the voltageLevelAdjacency Map all connected voltageLevels will be calculated
Two voltageLevels are connected if they are adjacent
(allConnected method)
All connected VoltageLevels to VL1 will be [VL1]
All connected VoltageLevels to VL2 will be [VL2, VL3, VL4]
All connected VoltageLevels to VL5 will be [VL5]
All connected VoltageLevels to VL6 will be [VL6, VL7]

So the following voltageLevels should be merged
[VL2, VL3, VL4] and the representative (IIDM voltageLevel) will be VL2
[VL6, VL7] and the representative (IIDM voltageLevel) will be VL6

And finally previous data is recorded in the voltageLevelMapping Map as
(For each merged voltageLevel a record (merged voltageLevel, representative voltageLevel) is added)
(VL3, VL2)
(VL4, VL2)
(VL7, VL6)

The voltageLevelMapping Map will be used to assign the IIDM voltageLevel during the conversion process

The same algorithm is used to identify the substations that should be merged but:
Two substations are adjacent if there is a transformer between them.
The two substations associated with two adjacent voltageLevels, are adjacent if they are different substations.

Author:
Luma Zamarreño <zamarrenolm at aia.es>, José Antonio Marqués <marquesja at aia.es>

  • Constructor Details

    • SubstationIdMapping

      public SubstationIdMapping(Context context)

  • Method Details

    • substationIsMapped

      public boolean substationIsMapped(String cgmesIdentifier)

    • substationIidm

      public String substationIidm(String cgmesIdentifier)

    • mergedSubstations

      public Set<String> mergedSubstations(String cgmesIdentifier)

    • voltageLevelIsMapped

      public boolean voltageLevelIsMapped(String cgmesIdentifier)

    • voltageLevelIidm

      public String voltageLevelIidm(String cgmesIdentifier)

    • mergedVoltageLevels

      public Set<String> mergedVoltageLevels(String cgmesIdentifier)

    • build

      public void build()