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

Class TapChangerConversion

java.lang.Object

com.powsybl.cgmes.conversion.elements.transformers.TapChangerConversion

public class TapChangerConversion
extends Object

TapChangerTypes

TapChangers are classified into four categories: NULL, FIXED, NON_REGULATING and REGULATING
NULL: TapChanger does not exist
FIXED: TapChanger has only one step
NON_REGULATING: TapChanger is not regulating. It has several steps
REGULATING: TapChanger is regulating and has several steps

These categories are used to establish a priority ranking when two tapChangers are combined to only one. The tapChanger with lower priority is fixed at the current tap position and the tapChanger with higher priority is preserved. NULL is the lowest priority and REGULATING the highest one.
If both tapChangers are regulating tapChanger at end2 is fixed.

The combineTapChanger method does a Cartesian product of two tapChangers getting as result a new tapChanger with steps1 x steps2 steps. The combined tapChanger will not be useful for network analysis and it is not possible to map back to the original one.
To avoid this, one of the tapChangers must be fixed. To do that the tapChangerFixPosition method is used.

A warning message is logged when a tapChanger is fixed.

When structural ratio is moved from one side to the other a correction is applied to transmission impedance (r, x) and shunt admittance (g and b).
When tapChanger is moved the transmission impedance and shunt admittance corrections are managed as step correction expressed as percentage deviation of nominal value.

Author:

Luma Zamarreño , José Antonio Marqués

Field Summary

Fields

Modifier and Type	Field	Description
protected Context	context

Method Summary

Modifier and Type	Method	Description
protected TapChanger	combineTapChangers(TapChanger tc1, TapChanger tc2)
protected static com.powsybl.cgmes.conversion.elements.transformers.TapChangerConversion.RatioConversion	identityRatioConversion(double r, double x, double g1, double b1, double g2, double b2)
protected static com.powsybl.cgmes.conversion.elements.transformers.TapChangerConversion.RatioConversion	moveRatioFrom1To2(double a, double angle, double r, double x, double g1, double b1, double g2, double b2)
protected static com.powsybl.cgmes.conversion.elements.transformers.TapChangerConversion.RatioConversion	moveRatioFrom2To1(double a, double angle, double r, double x, double g1, double b1, double g2, double b2)
protected static TapChanger	moveTapChangerFrom1To2(TapChanger tc)
protected static TapChanger	moveTapChangerFrom2To1(TapChanger tc)

Methods inherited from class java.lang.Object

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

Field Detail

context

protected final Context context

Method Detail

combineTapChangers

protected TapChanger combineTapChangers(TapChanger tc1,
                                        TapChanger tc2)

moveTapChangerFrom1To2

protected static TapChanger moveTapChangerFrom1To2(TapChanger tc)

moveTapChangerFrom2To1

protected static TapChanger moveTapChangerFrom2To1(TapChanger tc)

identityRatioConversion

protected static com.powsybl.cgmes.conversion.elements.transformers.TapChangerConversion.RatioConversion identityRatioConversion(double r,
                                                                                                                                 double x,
                                                                                                                                 double g1,
                                                                                                                                 double b1,
                                                                                                                                 double g2,
                                                                                                                                 double b2)

moveRatioFrom2To1

protected static com.powsybl.cgmes.conversion.elements.transformers.TapChangerConversion.RatioConversion moveRatioFrom2To1(double a,
                                                                                                                           double angle,
                                                                                                                           double r,
                                                                                                                           double x,
                                                                                                                           double g1,
                                                                                                                           double b1,
                                                                                                                           double g2,
                                                                                                                           double b2)

moveRatioFrom1To2

protected static com.powsybl.cgmes.conversion.elements.transformers.TapChangerConversion.RatioConversion moveRatioFrom1To2(double a,
                                                                                                                           double angle,
                                                                                                                           double r,
                                                                                                                           double x,
                                                                                                                           double g1,
                                                                                                                           double b1,
                                                                                                                           double g2,
                                                                                                                           double b2)