Class TwoWindingsTransformerConversion
- java.lang.Object
-
- com.powsybl.cgmes.conversion.elements.AbstractObjectConversion
-
- com.powsybl.cgmes.conversion.elements.AbstractIdentifiedObjectConversion
-
- com.powsybl.cgmes.conversion.elements.AbstractConductingEquipmentConversion
-
- com.powsybl.cgmes.conversion.elements.transformers.TwoWindingsTransformerConversion
-
- All Implemented Interfaces:
EquipmentAtBoundaryConversion
public class TwoWindingsTransformerConversion extends AbstractConductingEquipmentConversion implements EquipmentAtBoundaryConversion
TwoWindingsTransformer Cgmes ConversionCgmes conversion for transformers (two and three windings) is divided into four stages: load, interpret, convert and set.
Load
Native CGMES data is loaded from the triple store query and is put in the CGMES model object (CgmesT2xModel).Interpret
CgmesT2xModel data is mapped to a more general two windings transformer model (InterpretedT2xModel) according to a predefined configured alternative. It is an elemental process as the only objective is to put Cgmes data in the fields of the general two windings transformer model. All possible alternatives and the default one are defined in conversion class. SeeConversion
InterpretedT2xModel supports ratioTapChanger and phaseTapChanger at each end. Shunt admittances can be defined at both ends and allows to specify the end of the structural ratio.Convert
Converts the interpreted model (InterpretedT2xModel) to the converted model object (ConvertedT2xModel).
The ConvertedT2xModel only allows to define ratioTapChanger and phaseTapChanger at end1. Shunt admittances and structural ratio must be also at end1.
To do this process the following methods are used:
moveTapChangerFrom2To1: To move a tapChanger from end2 to end1
combineTapChanger: To reduce two tapChangers to one
moveRatioFrom2To1: To move structural ratio from end2 to end1
Finally shunt admittance of both ends are added to end1. This step is an approximation and only will be possible to reproduce the exact case result if Cgmes shunts are defined at end1 or are split and the LoadflowParameter splitShuntAdmittance option is selected.
SeeTapChangerConversion
Set
A direct map from ConvertedT2xModel to IIDM model- Author:
- Luma Zamarreño
, José Antonio Marqués
-
-
Field Summary
-
Fields inherited from class com.powsybl.cgmes.conversion.elements.AbstractIdentifiedObjectConversion
id, name
-
Fields inherited from class com.powsybl.cgmes.conversion.elements.AbstractObjectConversion
context, p, ps, type
-
-
Constructor Summary
Constructors Constructor Description TwoWindingsTransformerConversion(PropertyBags ends, Context context)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
addAliasesAndProperties(Identifiable<?> identifiable)
protected static void
addCgmesReferences(Identifiable<?> transformer, TapChanger tc)
BoundaryLine
asBoundaryLine(String boundaryNode)
void
convert()
void
convertAtBoundary()
protected RegulatingControlMappingForTransformers.CgmesRegulatingControlPhase
setContextRegulatingDataPhase(TapChanger tc)
protected RegulatingControlMappingForTransformers.CgmesRegulatingControlRatio
setContextRegulatingDataRatio(TapChanger tc)
protected static void
setToIidmPhaseTapChanger(TapChanger ptc, PhaseTapChangerAdder ptca, Context context)
protected static void
setToIidmRatioTapChanger(TapChanger rtc, RatioTapChangerAdder rtca)
boolean
valid()
-
Methods inherited from class com.powsybl.cgmes.conversion.elements.AbstractConductingEquipmentConversion
addMappingForTopologicalNode, addMappingForTopologicalNode, boundaryNode, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, convertedTerminals, convertInsideBoundary, convertToDanglingLine, convertToDanglingLine, createBoundaryLine, findUcteXnodeCode, findUcteXnodeCode, insideBoundary, isBoundary, nodeId, nodeId, nodeIdPropertyName, p0, q0, stateVariablesPowerFlow, substation, topologicalNodeId, voltageLevel
-
Methods inherited from class com.powsybl.cgmes.conversion.elements.AbstractIdentifiedObjectConversion
complete, id, identify, identify, identify, iidmId, iidmName, name, what
-
Methods inherited from class com.powsybl.cgmes.conversion.elements.AbstractObjectConversion
fixed, fixed, fixed, fromContinuous, ignored, ignored, ignored, inRange, invalid, invalid, invalid, missing, missing, presentMandatoryProperty
-
-
-
-
Constructor Detail
-
TwoWindingsTransformerConversion
public TwoWindingsTransformerConversion(PropertyBags ends, Context context)
-
-
Method Detail
-
valid
public boolean valid()
- Overrides:
valid
in classAbstractConductingEquipmentConversion
-
convert
public void convert()
- Specified by:
convert
in classAbstractObjectConversion
-
convertAtBoundary
public void convertAtBoundary()
- Specified by:
convertAtBoundary
in interfaceEquipmentAtBoundaryConversion
-
asBoundaryLine
public BoundaryLine asBoundaryLine(String boundaryNode)
- Specified by:
asBoundaryLine
in interfaceEquipmentAtBoundaryConversion
-
setToIidmRatioTapChanger
protected static void setToIidmRatioTapChanger(TapChanger rtc, RatioTapChangerAdder rtca)
-
setToIidmPhaseTapChanger
protected static void setToIidmPhaseTapChanger(TapChanger ptc, PhaseTapChangerAdder ptca, Context context)
-
setContextRegulatingDataRatio
protected RegulatingControlMappingForTransformers.CgmesRegulatingControlRatio setContextRegulatingDataRatio(TapChanger tc)
-
setContextRegulatingDataPhase
protected RegulatingControlMappingForTransformers.CgmesRegulatingControlPhase setContextRegulatingDataPhase(TapChanger tc)
-
addAliasesAndProperties
protected void addAliasesAndProperties(Identifiable<?> identifiable)
- Overrides:
addAliasesAndProperties
in classAbstractConductingEquipmentConversion
-
addCgmesReferences
protected static void addCgmesReferences(Identifiable<?> transformer, TapChanger tc)
-
-