Package com.powsybl.iidm.network

Interface ThreeWindingsTransformer

All Superinterfaces:
Connectable<ThreeWindingsTransformer>, Extendable<ThreeWindingsTransformer>, Identifiable<ThreeWindingsTransformer>
public interface ThreeWindingsTransformer extends Connectable<ThreeWindingsTransformer>
A Three Windings Power Transformer.

The equivalent star model used is:

Usually side 1 is the primary (high voltage), side 2 is the secondary (medium voltage) and side 3 the tertiary voltage (low voltage).

g1, g2, g3 and b1, b2, b3 unit is siemens.

r1, r2, r3, x1, x2 and x3 unit is ohm.

A Three Windings Transformer is connected to three voltage levels (side 1, side 2 and side 3) that belong to the same substation. It has three identical legs. Each leg has the same model of a Two Windings Power Transformer.

All three legs may have a Ratio Tap Changer and a Phase Tap Changer. A warning is emitted if a leg has both Ratio and Phase Tap Changers.

Only one Tap Changer is allowed to be regulating on the equipment. An exception is thrown if two or more regulating controls are enabled.

Characteristics

Attribute Type Unit Required Defaut value Description
Id String - yes - Unique identifier of the transformer
Name String - yes - Human-readable name of the transformer
RatedU0 double kV yes - The rated voltage at the star bus
Leg1 ThreeWindingsTransformer.Leg - yes - The leg at the primary side
Leg2 ThreeWindingsTransformer.Leg - yes - The leg at the secondary side
Leg3 ThreeWindingsTransformer.Leg - yes - The leg at the tertiary side

To create a three windings transformer, see ThreeWindingsTransformerAdder

Author:
Geoffroy Jamgotchian <geoffroy.jamgotchian at rte-france.com>
See Also:

  • Method Details

    • getTerminal

      Terminal getTerminal(ThreeSides side)

    • getSide

      ThreeSides getSide(Terminal terminal)
      Get the side the terminal is connected to.

    • getSubstation

      Optional<Substation> getSubstation()

    • getNullableSubstation

      default Substation getNullableSubstation()

    • getLeg1

      ThreeWindingsTransformer.Leg getLeg1()
      Get the leg at the primary side.

    • getLeg2

      ThreeWindingsTransformer.Leg getLeg2()
      Get the leg at the secondary side.

    • getLeg3

      ThreeWindingsTransformer.Leg getLeg3()
      Get the leg at the tertiary side.

    • getLeg

      default ThreeWindingsTransformer.Leg getLeg(ThreeSides side)

    • getLegStream

      default Stream<ThreeWindingsTransformer.Leg> getLegStream()
      Return the legs of this transformer, in the natural order (leg1, leg2 and leg3)

    • getLegs

      default List<ThreeWindingsTransformer.Leg> getLegs()
      Return the legs of this transformer, in the natural order (leg1, leg2 and leg3)

    • getRatedU0

      double getRatedU0()
      Get the ratedU at the fictitious bus in kV (also used as nominal voltage)

    • setRatedU0

      default ThreeWindingsTransformer setRatedU0(double ratedU0)
      Set the rated voltage at the fictitious bus.

    • getType

      default IdentifiableType getType()
      Description copied from interface: Identifiable
      Get identifiable type.
      Specified by:
      getType in interface Identifiable<ThreeWindingsTransformer>
      Returns:
      the identifiable type

    • isOverloaded

      boolean isOverloaded()
      Only checks overloading for LimitType.Current and permanent limits

    • isOverloaded

      boolean isOverloaded(double limitReductionValue)
      Only checks overloading for LimitType.Current and permanent limits

    • getOverloadDuration

      int getOverloadDuration()

    • checkPermanentLimit

      boolean checkPermanentLimit(ThreeSides side, double limitReductionValue, LimitType type)

    • checkPermanentLimit

      boolean checkPermanentLimit(ThreeSides side, LimitType type)

    • checkPermanentLimit1

      boolean checkPermanentLimit1(double limitReductionValue, LimitType type)

    • checkPermanentLimit1

      boolean checkPermanentLimit1(LimitType type)

    • checkPermanentLimit2

      boolean checkPermanentLimit2(double limitReductionValue, LimitType type)

    • checkPermanentLimit2

      boolean checkPermanentLimit2(LimitType type)

    • checkPermanentLimit3

      boolean checkPermanentLimit3(double limitReductionValue, LimitType type)

    • checkPermanentLimit3

      boolean checkPermanentLimit3(LimitType type)

    • checkTemporaryLimits

      Overload checkTemporaryLimits(ThreeSides side, double limitReductionValue, LimitType type)

    • checkTemporaryLimits

      Overload checkTemporaryLimits(ThreeSides side, LimitType type)

    • checkTemporaryLimits1

      Overload checkTemporaryLimits1(double limitReductionValue, LimitType type)

    • checkTemporaryLimits1

      Overload checkTemporaryLimits1(LimitType type)

    • checkTemporaryLimits2

      Overload checkTemporaryLimits2(double limitReductionValue, LimitType type)

    • checkTemporaryLimits2

      Overload checkTemporaryLimits2(LimitType type)

    • checkTemporaryLimits3

      Overload checkTemporaryLimits3(double limitReductionValue, LimitType type)

    • checkTemporaryLimits3

      Overload checkTemporaryLimits3(LimitType type)