com.powsybl.cgmes.conversion.elements.transformers

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

public class TwoWindingsTransformerConversion
extends AbstractConductingEquipmentConversion

TwoWindingsTransformer 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 (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. See Conversion
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.
See TapChangerConversion

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 and Description
TwoWindingsTransformerConversion(PropertyBags ends, Context context)

Method Summary

Modifier and Type	Method and Description
protected void	addAliases(Identifiable<?> identifiable)
void	convert()
protected RegulatingControlMappingForTransformers.CgmesRegulatingControlPhase	setContextRegulatingDataPhase(TapChanger tc)
protected RegulatingControlMappingForTransformers.CgmesRegulatingControlRatio	setContextRegulatingDataRatio(TapChanger tc)
protected static void	setToIidmPhaseTapChanger(TapChanger ptc, PhaseTapChangerAdder ptca)
protected static void	setToIidmRatioTapChanger(TapChanger rtc, RatioTapChangerAdder rtca)
boolean	valid()

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

connect, connect, connect, connect, connect, connect, connect, connect, connect, convertedTerminals, convertInsideBoundary, findUcteXnodeCode, insideBoundary, nodeId, nodeId, stateVariablesPowerFlow, substation, voltageLevel

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

complete, id, 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

Methods inherited from class java.lang.Object

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

Constructor Detail

TwoWindingsTransformerConversion

public TwoWindingsTransformerConversion(PropertyBags ends,
                                        Context context)

Method Detail

valid

public boolean valid()

Overrides:

valid in class AbstractConductingEquipmentConversion

convert

public void convert()

Specified by:

convert in class AbstractObjectConversion

setToIidmRatioTapChanger

protected static void setToIidmRatioTapChanger(TapChanger rtc,
                                               RatioTapChangerAdder rtca)

setToIidmPhaseTapChanger

protected static void setToIidmPhaseTapChanger(TapChanger ptc,
                                               PhaseTapChangerAdder ptca)

setContextRegulatingDataRatio

protected RegulatingControlMappingForTransformers.CgmesRegulatingControlRatio setContextRegulatingDataRatio(TapChanger tc)

setContextRegulatingDataPhase

protected RegulatingControlMappingForTransformers.CgmesRegulatingControlPhase setContextRegulatingDataPhase(TapChanger tc)

addAliases

protected void addAliases(Identifiable<?> identifiable)

Overrides:

addAliases in class AbstractConductingEquipmentConversion