Isc3WTransformer

The Isc3WTransformer class provides access to an IPSA 3-winding transformer, to set and get data values and to retrieve load flow and fault level results. In the following functions and field values the following conventions are used;

  • Primary winding = winding 1. Winding number nWinding = 1

  • Secondary winding = winding 2. Winding number nWinding = 2

  • Tertiary winding = winding 3. Winding number nWinding = 3

Field Values

Isc3WTransformer Field Values

Type

Field Name

Description

Integer

FromUID

Gets the unique ID of the primary winding busbar.

Integer

ToUID

Gets the unique ID of the secondary winding busbar.

Integer

ThreeUID

Gets the unique ID of the tertiary winding busbar.

String

FromBusName

Gets the primary winding busbar name.

String

ToBusName

Gets the secondary winding busbar name.

String

ThreeBusName

Gets the tertiary winding busbar name.

String

Name

Gets the 3-winding transformer name.

Integer

Status

Status:

  • 0 = All windings switched in

  • -1 = All windings switched out

Integer

Winding / VectorGroup

Transformer winding/VG type connection as follows:

  • 1 = none

  • 2 = xd1d1

  • 3 = xd1d11

  • 4 = xd11d1

  • 5 = xd11d11

  • 6 = xxd1

  • 7 = xxd11

  • 8 = xd1x

  • 9 = xd11x

  • 10 = xyd1

  • 11 = xyd11

  • 12 = xd1y

  • 13 = xd11y

  • 14 = ddx1

  • 15 = ddx11

  • 16 = dx1d

  • 17 = dx11d

  • 18 = ddy1

  • 19 = ddy11

  • 20 = dy1d

  • 21 = dy11d

  • 22 = dx1x1

  • 23 = dx11x11

  • 24 = dy1y1

  • 25 = dy11y11

  • 26 = dx1y1

  • 27 = dx11y11

  • 28 = dy1x1

  • 29 = dy11x11

  • 30 = yd1d1

  • 31 = yd1d11

  • 32 = yd11d1

  • 33 = yd11d11

  • 34 = yyd1

  • 35 = yyd11

  • 36 = yd1y

  • 37 = yd11y

  • 38 = yxd1

  • 39 = yxd11

  • 40 = yd1x

  • 41 = yd11x

  • 42 = xxy

  • 43 = xyx

  • 44 = yxx

  • 45 = yyx

  • 46 = yxy

  • 47 = xyy

  • 48 = xxx

  • 49 = yyy

  • 50 = ddd

where:

  • X = Earthed star

  • Y = Unearthed star

  • D = Delta

  • Z = Zig-zag

Float

W1W2ResistancePU

Gets and sets the winding 1 to winding 2 resistance in per unit.

Float

W1W2ReactancePU

Gets and sets the winding 1 to winding 2 reactance in per unit.

Float

W1W3ResistancePU

Gets and sets the winding 1 to winding 3 resistance in per unit.

Float

W1W3ReactancePU

Gets and sets the winding 1 to winding 3 reactance in per unit.

Float

W2W3ResistancePU

Gets and sets the winding 2 to winding 3 reactance in per unit.

Float

W2W3ReactancePU

Gets and sets the winding 2 to winding 3 reactance in per unit.

Float

W1W2ZSResistancePU

Gets and sets the winding 1 to winding 2 zero sequence resistance in per unit.

Float

W1W2ZSReactancePU

Gets and sets the winding 1 to winding 2 zero sequence reactance in per unit.

Float

W1W3ZSResistancePU

Gets and sets the winding 1 to winding 3 zero sequence resistance in per unit.

Float

W1W3ZSReactancePU

Gets and sets the winding 1 to winding 3 zero sequence reactance in per unit.

Float

W2W3ZSResistancePU

Gets and sets the winding 2 to winding 3 zero sequence resistance in per unit.

Float

W2W3ZSReactancePU

Gets and sets the winding 2 to winding 3 zero sequence reactance in per unit.

Float

W1NEResistancePU

Gets and sets the winding 1 neutral earth resistance in per unit.

Float

W1NEReactancePU

Gets and sets the winding 1 neutral earth reactance in per unit.

Float

W2NEResistancePU

Gets and sets the winding 2 neutral earth resistance in per unit.

Float

W2NEReactancePU

Gets and sets the winding 2 neutral earth reactance in per unit.

Float

W3NEResistancePU

Gets and sets the winding 3 neutral earth resistance in per unit.

Float

W3NEReactancePU

Gets and sets the winding 3 neutral earth reactance in per unit.

Boolean

LockTap

Gets and sets the flag to lock the tap changer on the primary winding.

Float

W1TapNominalPC

Gets and sets the winding 1 nominal tap position in percent, optionally used in a flat start.

Float

W2TapNominalPC

Gets and sets the winding 2 nominal tap position in percent, optionally used in a flat start.

Float

W3TapNominalPC

Gets and sets the winding 3 nominal tap position in percent, optionally used in a flat start.

Float

W1TapStartPC

Gets and sets the winding 1 tap position in percent, used as a starting point for the next load flow.

Float

W2TapStartPC

Gets and sets the winding 2 tap position in percent, used as a starting point for the next load flow.

Float

W3TapStartPC

Gets and sets the winding 3 tap position in percent, used as a starting point for the next load flow.

Float

W1MinTapPC

Gets and sets the winding 1 minimum tap position in percent, normally negative or zero.

Float

W2MinTapPC

Gets and sets the winding 2 minimum tap position in percent, normally negative or zero.

Float

W3MinTapPC

Gets and sets the winding 3 minimum tap position in percent, normally negative or zero.

Float

W1TapStepPC

Gets and sets the winding 1 tap increment in percent. This defaults to 0.01 if left blank.

Float

W2TapStepPC

Gets and sets the winding 2 tap increment in percent. This defaults to 0.01 if left blank.

Float

W3TapStepPC

Gets and sets the winding 3 tap increment in percent. This defaults to 0.01 if left blank.

Float

W1MaxTapPC

Gets and sets the winding 1 maximum tap position in percent, normally positive or zero.

Float

W2MaxTapPC

Gets and sets the winding 2 maximum tap position in percent, normally positive or zero.

Float

W3MaxTapPC

Gets and sets the winding 3 maximum tap position in percent, normally positive or zero.

Float

W1SpecVPU

Gets and sets the winding 1 target voltage in per unit. Positive values only. Magnitudes of less than 0.5 pu mean fixed tap operation.

Integer

W1SpecVWinding

Specifies the busbar whose voltage is controlled by the tap changer on winding 1.

Float

W1RBWidthPC

Full bandwidth of the winding 1 voltage sensing relay. This should be larger than tap step size.

Float

W1CompRPC

Winding 1 line drop compensation resistance in percentage on the compensation rating base.

Float

W1CompXPC

Winding 1 line drop compensation reactance in percentage on the compensation rating base.

Float

W1CompRatingMVA

Winding 1 line drop compensation rating in MVA used to provide load compensation.

Float

VoltFactorPt

Sets the voltage factor for use in IEC60909 fault calculations.

Integer

HarmonicModel

Transformer harmonic model. One of the following:

  • 0 = Polynomial resistance mode

  • 1 = Resistance square root model

  • 2 = Constant X/R model

Float

HarmRC0 HarmRC12 HarmRC1 HarmRC2 HarmRC3

Harmonic polynomial constants RC0, RC12, RC1, RC2 and RC3 in:

\(R_{h} = R[RC0 + RC12.h^{0.5} 0 + RC1.h + RC2.h^2 + RC3.h^3]\)

Float

FailureRateYr

3W transformer failure rate per annum.

Float

RepairTimeHr

3W transformer repair time in hours.

Isc3WTransformer Class

class ipsa.Isc3WTransformer

Provides access to an IPSA 3-winding transformer.

SetName(strName: str) → bool

Sets the name as a string.

Parameters:

strName (str) – The selected string name.

Returns:

True if successful.

Return type:

bool

GetIValue(nFieldIndex: int) → int

Returns an integer value for the enumerated field.

Parameters:

nFieldIndex (int) – The field index.

Returns:

The integer value.

Return type:

int

GetDValue(nFieldIndex: int) → float

Returns a double value for the enumerated field.

Parameters:

nFieldIndex (int) – The field index.

Returns:

The double value.

Return type:

float

GetSValue(nFieldIndex: int) → str

Returns a string value for the enumerated field.

Parameters:

nFieldIndex (int) – The field index.

Returns:

The string value.

Return type:

str

GetBValue(nFieldIndex: int) → bool

Returns a boolean value for the enumerated field.

Parameters:

nFieldIndex (int) – The field index.

Returns:

The boolean value.

Return type:

bool

SetIValue(nFieldIndex: int, nValue: int) → bool

Sets the value for the enumerated field from an integer.

Parameters:

  • nFieldIndex (int) – The field index.

  • nValue (int) – The given integer value.

Returns:

True if successful.

Return type:

bool

SetDValue(nFieldIndex: int, dValue: float) → bool

Sets the value for the enumerated field from a double.

Parameters:

  • nFieldIndex (int) – The field index.

  • dValue (float) – The given double value.

Returns:

True if successful.

Return type:

bool

SetSValue(nFieldIndex: int, strValue: int) → bool

Sets the value for the enumerated field from a string.

Parameters:

  • nFieldIndex (int) – The field index.

  • strValue (str) – The given string value.

Returns:

True if successful.

Return type:

bool

SetBValue(nFieldIndex: int, bValue: bool) → bool

Sets the value for the enumerated field from boolean.

Parameters:

  • nFieldIndex (int) – The field index.

  • bValue (bool) – The given boolean value.

Returns:

True if successful.

Return type:

bool

GetWindingRatingMVA(nWinding: int, nRatingIndex: int) → float

Returns the MVA rating for the 3-winding transformer for the specified rating set.

Parameters:

  • nWinding (int) – The winding number.

  • nRatingIndex (int) – The specified rating index.

Returns:

The MVA rating for the 3-winding transformer.

Return type:

float

SetWindingRatingMVA(nSection: int, nRatingIndex: int, dRatingMVA: float) → None

Sets the MVA rating to dRatingMVA for the specified rating set.

Parameters:

  • nSection (int) – The number of sections.

  • nRatingIndex (int) – The specified rating index.

  • dRatingMVA (float) – The MVA rating that is set.

GetLargestPowerMagnitudeMVA() → float

Returns the highest 3-winding transformer end power in MVA.

Returns:

The highest 3-winding transformer end power in MVA.

Return type:

float

GetLargestPowerMagnitudekVA() → float

Returns the highest 3-winding transformer end power in kVA.

Returns:

The highest 3-winding transformer end power in kVA.

Return type:

float

GetLargestRealPowerMW() → float

Returns the highest 3-winding transformer end power in MW.

Returns:

The highest 3-winding transformer end power in MW.

Return type:

float

GetLargestReactivePowerMVAr() → float

Returns the highest 3-winding transformer end power in MVAr.

Returns:

The highest 3-winding transformer end power in MVAr.

Return type:

float

GetLargestRealPowerkW() → float

Returns the highest 3-winding transformer end power in kW.

Returns:

The highest 3-winding transformer end power in kW.

Return type:

float

GetLargestReactivePowerkVAr() → float

Returns the highest 3-winding transformer end power in kVAr.

Returns:

The highest 3-winding transformer end power in kVAr.

Return type:

float

GetLossesMW() → float

Returns the 3-winding transformer losses in MW.

Returns:

The 3-winding transformer losses in MW.

Return type:

float

GetLossesMVAr() → float

Returns the 3-winding transformer losses in MVAr.

Returns:

The 3-winding transformer losses in MVAr.

Return type:

float

GetLosseskW() → float

Returns the 3-winding transformer losses in kW.

Returns:

The 3-winding transformer losses in kW.

Return type:

float

GetLosseskVAr() → float

Returns the 3-winding transformer losses in kVAr.

Returns:

The 3-winding transformer losses in kVAr.

Return type:

float

GetWindingPowerMagnitudeMVA(nWinding: int) → float

Returns the MVA power flow in the specified winding for the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The MVA power flow in the specified winding for the 3-winding transformer.

Return type:

float

GetWindingPowerMagnitudekVA(nWinding: int) → float

Returns the kVA power flow in the specified winding for the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The kVA power flow in the specified winding for the 3-winding transformer.

Return type:

float

GetWindingRealPowerMW(nWinding: int) → float

Returns the MW power flow in the specified winding for the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The MW power flow in the specified winding for the 3-winding transformer.

Return type:

float

GetWindingReactivePowerMVAr(nWinding: int) → float

Returns the MVAr power flow in the specified winding for the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The MVAr power flow in the specified winding for the 3-winding transformer.

Return type:

float

GetWindingRealPowerkW(nWinding: int) → float

Returns the kW power flow in the specified winding for the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The kW power flow in the specified winding for the 3-winding transformer.

Return type:

float

GetWindingReactivePowerkVAr(nWinding: int) → float

Returns the kVAr power flow in the specified winding for the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The kVAr power flow in the specified winding for the 3-winding transformer.

Return type:

float

GetFaultRedComponentMVA(nWinding: int) → float

Returns the red phase fault level component in MVA for the specified winding of the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The red phase fault level component in MVA for the specified winding of the 3-winding transformer.

Return type:

float

GetFaultYellowComponentMVA(nWinding: int) → float

Returns the yellow phase fault level component in MVA for the specified winding of the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The yellow phase fault level component in MVA for the specified winding of the 3-winding transformer.

Return type:

float

GetFaultBlueComponentMVA(nWinding: int) → float

Returns the blue phase fault level component in MVA for the specified winding of the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The blue phase fault level component in MVA for the specified winding of the 3-winding transformer.

Return type:

float

GetFaultPositiveComponentMVA(nWinding: int) → float

Returns the positive sequence fault level component in MVA for the specified winding of the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The positive sequence fault level component in MVA for the specified winding of the 3-winding transformer.

Return type:

float

GetFaultNegativeComponentMVA(nWinding: int) → float

Returns the negative sequence fault level component in MVA for the specified winding of the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The negative sequence fault level component in MVA for the specified winding of the 3-winding transformer.

Return type:

float

GetFaultZeroComponentMVA(nWinding: int) → float

Returns the zero sequence fault level component in MVA for the specified winding of the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The zero sequence fault level component in MVA for the specified winding of the 3-winding transformer.

Return type:

float

GetCurrentMagnitude(nWinding: int, dOrder: float) → float

Returns the current magnitude for the specified winding in per unit on the network base for the harmonic order.

Parameters:

  • nWinding (int) – The winding number.

  • dOrder (float) – The harmonic order.

Returns:

The current magnitude in per unit.

Return type:

float

GetCurrentAngle(nWinding: int, dOrder: float) → float

Returns the current angle magnitude for the specified winding in radians for the harmonic order.

Parameters:

  • nWinding (int) – The winding number.

  • dOrder (float) – The harmonic order.

Returns:

The current angle magnitude in radians.

Return type:

float

GetResistance(nWinding: int, dOrder: float) → float

Returns the transformer harmonic resistance for the specified winding in per unit on the network base for the harmonic order.

Parameters:

  • nWinding (int) – The winding number.

  • dOrder (float) – The harmonic order.

Returns:

The transformer harmonic resistance in per unit.

Return type:

float

GetReactance(nWinding: int, dOrder: float) → float

Returns the transformer harmonic reactance for the specified winding in per unit on the network base for the harmonic order.

Parameters:

  • nWinding (int) – The winding number.

  • dOrder (float) – The harmonic order.

Returns:

The transformer harmonic reactance in per unit.

Return type:

float

GetDCLFLargestPowerMagnitudeMVA() → float

Returns the highest 3-winding transformer end power in MVA.

Returns:

The highest 3-winding transformer end power in MVA.

Return type:

float

GetDCLFLargestPowerMagnitudekVA() → float

Returns the highest 3-winding transformer end power in kVA.

Returns:

The highest 3-winding transformer end power in kVA.

Return type:

float

GetDCLFLargestRealPowerMW() → float

Returns the highest 3-winding transformer end power in MW.

Returns:

The highest 3-winding transformer end power in MW.

Return type:

float

GetDCLFLargestRealPowerkW() → float

Returns the highest 3-winding transformer end power in kW.

Returns:

The highest 3-winding transformer end power in kW.

Return type:

float

GetDCLFLossesMW() → float

Returns the 3-winding transformer losses in MW.

Returns:

The 3-winding transformer losses in MW.

Return type:

float

GetDCLFLosseskW() → float

Returns the 3-winding transformer losses in kW.

Returns:

The 3-winding transformer losses in kW.

Return type:

float

GetDCLFWindingPowerMagnitudeMVA(nWinding: int) → float

Returns the MVA power flow in winding for the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The MVA power flow in winding for the 3-winding transformer.

Return type:

float

GetDCLFWindingPowerMagnitudekVA(nWinding: int) → float

Returns the kVA power flow in winding for the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The kVA power flow in winding for the 3-winding transformer.

Return type:

float

GetDCLFWindingRealPowerMW(nWinding: int) → float

Returns the MW power flow in winding for the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The MW power flow in winding for the 3-winding transformer.

Return type:

float

GetDCLFWindingRealPowerkW(nWinding: int) → float

Returns the kW power flow in winding for the 3-winding transformer.

Parameters:

nWinding (int) – The winding number.

Returns:

The kW power flow in winding for the 3-winding transformer.

Return type:

float