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:

• RatioTapChanger
• PhaseTapChanger
• ThreeWindingsTransformerAdder

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	ThreeWindingsTransformer.Leg	Transformer leg

Method Summary

Modifier and Type	Method	Description
boolean	checkPermanentLimit(ThreeSides side, float limitReduction, LimitType type)
boolean	checkPermanentLimit(ThreeSides side, LimitType type)
boolean	checkPermanentLimit1(float limitReduction, LimitType type)
boolean	checkPermanentLimit1(LimitType type)
boolean	checkPermanentLimit2(float limitReduction, LimitType type)
boolean	checkPermanentLimit2(LimitType type)
boolean	checkPermanentLimit3(float limitReduction, LimitType type)
boolean	checkPermanentLimit3(LimitType type)
Overload	checkTemporaryLimits(ThreeSides side, float limitReduction, LimitType type)
Overload	checkTemporaryLimits(ThreeSides side, LimitType type)
Overload	checkTemporaryLimits1(float limitReduction, LimitType type)
Overload	checkTemporaryLimits1(LimitType type)
Overload	checkTemporaryLimits2(float limitReduction, LimitType type)
Overload	checkTemporaryLimits2(LimitType type)
Overload	checkTemporaryLimits3(float limitReduction, LimitType type)
Overload	checkTemporaryLimits3(LimitType type)
default ThreeWindingsTransformer.Leg	getLeg(ThreeSides side)
ThreeWindingsTransformer.Leg	getLeg1()	Get the leg at the primary side.
ThreeWindingsTransformer.Leg	getLeg2()	Get the leg at the secondary side.
ThreeWindingsTransformer.Leg	getLeg3()	Get the leg at the tertiary side.
default List<ThreeWindingsTransformer.Leg>	getLegs()	Return the legs of this transformer, in the natural order (leg1, leg2 and leg3)
default Stream<ThreeWindingsTransformer.Leg>	getLegStream()	Return the legs of this transformer, in the natural order (leg1, leg2 and leg3)
default Substation	getNullableSubstation()
int	getOverloadDuration()
double	getRatedU0()	Get the ratedU at the fictitious bus in kV (also used as nominal voltage)
ThreeSides	getSide(Terminal terminal)	Get the side the terminal is connected to.
Optional<Substation>	getSubstation()
Terminal	getTerminal(ThreeSides side)
default IdentifiableType	getType()	Get identifiable type.
boolean	isOverloaded()	Only checks overloading for LimitType.Current and permanent limits
boolean	isOverloaded(float limitReduction)	Only checks overloading for LimitType.Current and permanent limits

Methods inherited from interface com.powsybl.iidm.network.Connectable

connect, connect, disconnect, disconnect, getTerminals, remove

Methods inherited from interface com.powsybl.commons.extensions.Extendable

addExtension, getExtension, getExtensionByName, getExtensions, getImplementationName, newExtension, removeExtension

Methods inherited from interface com.powsybl.iidm.network.Identifiable

addAlias, addAlias, addAlias, addAlias, getAliases, getAliasFromType, getAliasType, getId, getNameOrId, getNetwork, getOptionalName, getParentNetwork, getProperty, getProperty, getPropertyNames, hasAliases, hasProperty, hasProperty, isFictitious, removeAlias, removeProperty, setFictitious, setName, setProperty

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)

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(float limitReduction)

Only checks overloading for LimitType.Current and permanent limits

getOverloadDuration

int getOverloadDuration()

checkPermanentLimit

boolean checkPermanentLimit(ThreeSides side,
 float limitReduction,
 LimitType type)

checkPermanentLimit

boolean checkPermanentLimit(ThreeSides side,
 LimitType type)

checkPermanentLimit1

boolean checkPermanentLimit1(float limitReduction,
 LimitType type)

checkPermanentLimit1

boolean checkPermanentLimit1(LimitType type)

checkPermanentLimit2

boolean checkPermanentLimit2(float limitReduction,
 LimitType type)

checkPermanentLimit2

boolean checkPermanentLimit2(LimitType type)

checkPermanentLimit3

boolean checkPermanentLimit3(float limitReduction,
 LimitType type)

checkPermanentLimit3

boolean checkPermanentLimit3(LimitType type)

checkTemporaryLimits

Overload checkTemporaryLimits(ThreeSides side,
 float limitReduction,
 LimitType type)

checkTemporaryLimits

Overload checkTemporaryLimits(ThreeSides side,
 LimitType type)

checkTemporaryLimits1

Overload checkTemporaryLimits1(float limitReduction,
 LimitType type)

checkTemporaryLimits1

Overload checkTemporaryLimits1(LimitType type)

checkTemporaryLimits2

Overload checkTemporaryLimits2(float limitReduction,
 LimitType type)

checkTemporaryLimits2

Overload checkTemporaryLimits2(LimitType type)

checkTemporaryLimits3

Overload checkTemporaryLimits3(float limitReduction,
 LimitType type)

checkTemporaryLimits3

Overload checkTemporaryLimits3(LimitType type)