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 <zamarrenolm at aia.es>, José Antonio Marqués <marquesja at aia.es>

  • Field Details

    • context

      protected final Context context

  • Method Details

    • 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)