com.powsybl.iidm.network

Interface TwoWindingsTransformer

All Superinterfaces:

Branch<TwoWindingsTransformer>, Connectable<TwoWindingsTransformer>, Extendable<TwoWindingsTransformer>, Identifiable<TwoWindingsTransformer>, PhaseTapChangerHolder, RatioTapChangerHolder

public interface TwoWindingsTransformer
extends Branch<TwoWindingsTransformer>, RatioTapChangerHolder, PhaseTapChangerHolder

A two windings power transformer.

The equivalent π model used is:

b, g, r, x shall be specified at the side 2 voltage.

b and g unit is siemens, r and x unit is ohm.

b, g, r, x, ρ and α variables in the model can be computed with the following Java code supposing transfo is an instance of TwoWindingsTransformer.

r = transfo.getR()
    * (1 + (transfo.getRatioTapChanger() != null ? transfo.getRatioTapChanger().getCurrentStep().getR() / 100 : 0)
       + (transfo.getPhaseTapChanger() != null ? transfo.getPhaseTapChanger().getCurrentStep().getR() / 100 : 0));
x = transfo.getX()
    * (1 + (transfo.getRatioTapChanger() != null ? transfo.getRatioTapChanger().getCurrentStep().getX() / 100 : 0)
       + (transfo.getPhaseTapChanger() != null ? transfo.getPhaseTapChanger().getCurrentStep().getX() / 100 : 0));
g = transfo.getG()
    * (1 + (transfo.getRatioTapChanger() != null ? transfo.getRatioTapChanger().getCurrentStep().getG() / 100 : 0)
       + (transfo.getPhaseTapChanger() != null ? transfo.getPhaseTapChanger().getCurrentStep().getG() / 100 : 0));
b = transfo.getB()
    * (1 + (transfo.getRatioTapChanger() != null ? transfo.getRatioTapChanger().getCurrentStep().getB() / 100 : 0)
       + (transfo.getPhaseTapChanger() != null ? transfo.getPhaseTapChanger().getCurrentStep().getB() / 100 : 0));
rho = transfo.getRatedU2() / transfo.getRatedU1()
    * (transfo.getRatioTapChanger() != null ? transfo.getRatioTapChanger().getCurrentStep().getRho() : 1);
    * (transfo.getPhaseTapChanger() != null ? transfo.getPhaseTapChanger().getCurrentStep().getRho() : 1);
alpha = (transfo.getPhaseTapChanger() != null ? transfo.getPhaseTapChanger().getCurrentStep().getAlpha() : 0);

A 2 windings transformer is connected to 2 voltage levels (side 1 and side 2) that belong to the same substation.

To create a 2 windings transformer, see TwoWindingsTransformerAdder

See Also:

RatioTapChanger, PhaseTapChanger, TwoWindingsTransformerAdder

Nested Class Summary

Nested classes/interfaces inherited from interface com.powsybl.iidm.network.Branch

Branch.Overload, Branch.Side

Method Summary

Modifier and Type	Method and Description
double	getB() Get the nominal magnetizing susceptance specified in S at the secondary voltage side.
double	getG() Get the nominal magnetizing conductance specified in S at the secondary voltage side.
double	getR() Get the nominal series resistance specified in Ω at the secondary voltage side.
double	getRatedU1() Get the primary winding rated voltage in kV.
double	getRatedU2() Get the secondary winding rated voltage in kV.
Substation	getSubstation() Get the substation to which the transformer belongs.
double	getX() Get the nominal series reactance specified in Ω at the secondary voltage side.
TwoWindingsTransformer	setB(double b) Set the nominal magnetizing susceptance specified in S at the secondary voltage side.
TwoWindingsTransformer	setG(double g) Set the nominal magnetizing conductance specified in S at the secondary voltage side.
TwoWindingsTransformer	setR(double r) Set the nominal series resistance specified in Ω at the secondary voltage side.
TwoWindingsTransformer	setRatedU1(double ratedU1) Set the secondary winding rated voltage in kV.
TwoWindingsTransformer	setRatedU2(double ratedU2) Set the secondary winding rated voltage in kV.
TwoWindingsTransformer	setX(double x) Set the nominal series reactance specified in Ω at the secondary voltage side.

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

checkPermanentLimit, checkPermanentLimit, checkPermanentLimit1, checkPermanentLimit1, checkPermanentLimit2, checkPermanentLimit2, checkTemporaryLimits, checkTemporaryLimits, checkTemporaryLimits1, checkTemporaryLimits1, checkTemporaryLimits2, checkTemporaryLimits2, getCurrentLimits, getCurrentLimits1, getCurrentLimits2, getOverloadDuration, getSide, getTerminal, getTerminal, getTerminal1, getTerminal2, isOverloaded, isOverloaded, newCurrentLimits1, newCurrentLimits2

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

getTerminals, getType, remove

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

getId, getName, getProperties, hasProperty

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

addExtension, getExtension, getExtensionByName, getExtensions, removeExtension

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

getRatioTapChanger, newRatioTapChanger

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

getPhaseTapChanger, newPhaseTapChanger

Method Detail

getSubstation

Substation getSubstation()

Get the substation to which the transformer belongs.

getR

double getR()

Get the nominal series resistance specified in Ω at the secondary voltage side.

setR

TwoWindingsTransformer setR(double r)

Set the nominal series resistance specified in Ω at the secondary voltage side.

getX

double getX()

Get the nominal series reactance specified in Ω at the secondary voltage side.

setX

TwoWindingsTransformer setX(double x)

Set the nominal series reactance specified in Ω at the secondary voltage side.

getG

double getG()

Get the nominal magnetizing conductance specified in S at the secondary voltage side.

setG

TwoWindingsTransformer setG(double g)

Set the nominal magnetizing conductance specified in S at the secondary voltage side.

getB

double getB()

Get the nominal magnetizing susceptance specified in S at the secondary voltage side.

setB

TwoWindingsTransformer setB(double b)

Set the nominal magnetizing susceptance specified in S at the secondary voltage side.

getRatedU1

double getRatedU1()

Get the primary winding rated voltage in kV.

setRatedU1

TwoWindingsTransformer setRatedU1(double ratedU1)

Set the secondary winding rated voltage in kV.

getRatedU2

double getRatedU2()

Get the secondary winding rated voltage in kV.

setRatedU2

TwoWindingsTransformer setRatedU2(double ratedU2)

Set the secondary winding rated voltage in kV.