Package com.powsybl.cgmes.conversion.elements.transformers

Class ThreeWindingsTransformerConversion

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.ThreeWindingsTransformerConversion

public class ThreeWindingsTransformerConversion
extends AbstractConductingEquipmentConversion

ThreeWindingsTransformer Cgmes Conversion

Cgmes 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 (CgmesT3xModel).

Interpret
CgmesT3xModel data is mapped to a more general three windings transformer model (InterpretedT3xModel) 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 three windings transformer model. All possible alternatives and the default one are defined in conversion class. See Conversion
InterpretedT3xModel supports ratioTapChanger and phaseTapChanger at each end of any leg. Shunt admittances can also be defined at both ends of each leg and allows to specify the end of the structural ratio by leg.

Convert
Converts the interpreted model (InterpretedT3xModel) to the converted model object (ConvertedT3xModel).
The ConvertedT3xModel only allows to define ratioTapChanger and phaseTapChanger at the network side of any leg. Shunt admittances and structural ratio must be also at the network side.
To do this process the following methods are applied to each leg:
moveTapChangerFrom2To1: To move a tapChanger from star bus side to network side
combineTapChanger: To reduce two tapChangers to one
moveRatioFrom2To1: To move structural ratio from star bus side to network side
Finally shunt admittance of both ends of the leg are added to network side. This step is an approximation and only will be possible to reproduce the exact case result if Cgmes shunts are defined at network side or are split and the LoadflowParameter splitShuntAdmittance option is selected.
See TapChangerConversion

Set
A direct map from ConvertedT3xModel to IIDM model

Author:

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

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
ThreeWindingsTransformerConversion(PropertyBags ends, Context context)

Method Summary

Modifier and Type	Method	Description
protected void	addAliasesAndProperties(Identifiable<?> identifiable)
protected static <C extends Connectable<C>> void	addCgmesReferences(C transformer, TapChanger tc)
static void	calculateVoltageAndAngleInStarBus(ThreeWindingsTransformer twt)
void	convert()
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)

Methods inherited from class com.powsybl.cgmes.conversion.elements.AbstractConductingEquipmentConversion

boundaryNode, calculateVoltageAndAngleInBoundaryBus, calculateVoltageAndAngleInBoundaryBus, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connectivityNodeId, convertedTerminals, convertInsideBoundary, convertToDanglingLine, convertToDanglingLine, findPairingKey, findPairingKey, insideBoundary, isBoundary, nodeId, nodeId, nodeIdPropertyName, p0, q0, stateVariablesPowerFlow, substation, topologicalNodeId, valid, voltageLevel

Methods inherited from class com.powsybl.cgmes.conversion.elements.AbstractIdentifiedObjectConversion

complete, id, identify, identify, identify, identify, iidmId, iidmName, name, what

Methods inherited from class com.powsybl.cgmes.conversion.elements.AbstractObjectConversion

fixed, fixed, fixed, fromContinuous, ignored, ignored, ignored, invalid, missing, missing

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ThreeWindingsTransformerConversion

public ThreeWindingsTransformerConversion(PropertyBags ends,
 Context context)

Method Details

convert

public void convert()

Specified by:

convert in class AbstractObjectConversion

calculateVoltageAndAngleInStarBus

public static void calculateVoltageAndAngleInStarBus(ThreeWindingsTransformer twt)

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 class AbstractConductingEquipmentConversion

addCgmesReferences

protected static <C extends Connectable<C>> void addCgmesReferences(C transformer,
 TapChanger tc)