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 = 1Secondary winding = winding 2. Winding number
nWinding = 2Tertiary winding = winding 3. Winding number
nWinding = 3
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:
|
Integer |
Winding / VectorGroup |
Transformer winding/VG type connection as follows:
|
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:
|
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 |
SwitchTime1Sec |
3W transformer switching time 1. |
Float |
SwitchTime2Sec |
3W transformer switching time 2. |
Float |
FailureRateYr |
3W transformer failure rate per annum. |
Float |
RepairTimeHr |
3W transformer repair time in hours. |
List[Float] |
W1RatingMVAs |
Winding 1 ratings for all rating sets in MVA. |
List[Float] |
W2RatingMVAs |
Winding 2 ratings for all rating sets in MVA. |
List[Float] |
W3RatingMVAs |
Winding 3 ratings for all rating sets in MVA. |
String |
PluginID |
Plugin Name, empty string means no plugin is assigned. |
String |
DbType |
Gets and sets the database type. |
Isc3WTransformer Class
- class ipsa.Isc3WTransformer
Provides access to an IPSA 3-winding transformer.
- GetListDValue(nFieldIndex: int) List[float]
Returns a list of double values for the enumerated field.
- SetIValue(nFieldIndex: int, nValue: int) bool
Sets the value for the enumerated field from an integer.
- SetDValue(nFieldIndex: int, dValue: float) bool
Sets the value for the enumerated field from a double.
- SetSValue(nFieldIndex: int, strValue: int) bool
Sets the value for the enumerated field from a string.
- SetBValue(nFieldIndex: int, bValue: bool) bool
Sets the value for the enumerated field from boolean.
- SetListDValue(nFieldIndex: int, lDValue: List[float]) bool
Sets the value for the enumerated field from a list of doubles.
- GetWindingRatingMVA(nWinding: int, nRatingIndex: int) float
Returns the MVA rating for the 3-winding transformer for the specified rating set.
- SetWindingRatingMVA(nSection: int, nRatingIndex: int, dRatingMVA: float) None
Sets the MVA rating to dRatingMVA for the specified rating 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:
- GetLargestPowerMagnitudekVA() float
Returns the highest 3-winding transformer end power in kVA.
- Returns:
The highest 3-winding transformer end power in kVA.
- Return type:
- GetLargestRealPowerMW() float
Returns the highest 3-winding transformer end power in MW.
- Returns:
The highest 3-winding transformer end power in MW.
- Return type:
- GetLargestReactivePowerMVAr() float
Returns the highest 3-winding transformer end power in MVAr.
- Returns:
The highest 3-winding transformer end power in MVAr.
- Return type:
- GetLargestRealPowerkW() float
Returns the highest 3-winding transformer end power in kW.
- Returns:
The highest 3-winding transformer end power in kW.
- Return type:
- GetLargestReactivePowerkVAr() float
Returns the highest 3-winding transformer end power in kVAr.
- Returns:
The highest 3-winding transformer end power in kVAr.
- Return type:
- GetLossesMW() float
Returns the 3-winding transformer losses in MW.
- Returns:
The 3-winding transformer losses in MW.
- Return type:
- GetLossesMVAr() float
Returns the 3-winding transformer losses in MVAr.
- Returns:
The 3-winding transformer losses in MVAr.
- Return type:
- GetLosseskW() float
Returns the 3-winding transformer losses in kW.
- Returns:
The 3-winding transformer losses in kW.
- Return type:
- GetLosseskVAr() float
Returns the 3-winding transformer losses in kVAr.
- Returns:
The 3-winding transformer losses in kVAr.
- Return type:
- GetWindingPowerMagnitudeMVA(nWinding: int) float
Returns the MVA power flow in the specified winding for the 3-winding transformer.
- GetWindingPowerMagnitudekVA(nWinding: int) float
Returns the kVA power flow in the specified winding for the 3-winding transformer.
- GetWindingRealPowerMW(nWinding: int) float
Returns the MW power flow in the specified winding for the 3-winding transformer.
- GetWindingReactivePowerMVAr(nWinding: int) float
Returns the MVAr power flow in the specified winding for the 3-winding transformer.
- GetWindingRealPowerkW(nWinding: int) float
Returns the kW power flow in the specified winding for the 3-winding transformer.
- GetWindingReactivePowerkVAr(nWinding: int) float
Returns the kVAr power flow in the specified winding for the 3-winding transformer.
- GetLineLoadingPC(nRatingIndex: int, bRatingMVA: bool) List[float]
Returns the line loading result for the specified rating as a percentage for the from and to end of the 3W transformer. Note, this will return -1 if the specified ratings aren’t set or can’t be found. NB. currently there are no kA ratings for 3W transformers. The list returned will be empty if there are no load flow results found.
- Parameters:
- Returns:
The line loading percentage for the from end, to end and three end in order.
- Return type:
- GetFaultRedComponentMVA(nWinding: int) float
Returns the red phase fault level component in MVA for the specified winding of the 3-winding transformer.
- GetFaultYellowComponentMVA(nWinding: int) float
Returns the yellow phase fault level component in MVA for the specified winding of the 3-winding transformer.
- GetFaultBlueComponentMVA(nWinding: int) float
Returns the blue phase fault level component in MVA for the specified winding of the 3-winding transformer.
- GetFaultPositiveComponentMVA(nWinding: int) float
Returns the positive sequence fault level component in MVA for the specified winding of the 3-winding transformer.
- GetFaultNegativeComponentMVA(nWinding: int) float
Returns the negative sequence fault level component in MVA for the specified winding of the 3-winding transformer.
- GetFaultZeroComponentMVA(nWinding: int) float
Returns the zero sequence fault level component in MVA for the specified winding of the 3-winding transformer.
- GetFaultRedMagnitudekA(nWinding: int) float
Returns the red phase fault level component in kA for the specified winding of the 3-winding transformer.
- GetFaultYellowMagnitudekA(nWinding: int) float
Returns the yellow phase fault level component in kA for the specified winding of the 3-winding transformer.
- GetFaultBlueMagnitudekA(nWinding: int) float
Returns the blue phase fault level component in kA for the specified winding of the 3-winding transformer.
- GetFaultPositiveMagnitudekA(nWinding: int) float
Returns the positive sequence fault level component in kA for the specified winding of the 3-winding transformer.
- GetFaultNegativeMagnitudekA(nWinding: int) float
Returns the negative sequence fault level component in kA for the specified winding of the 3-winding transformer.
- GetFaultZeroMagnitudekA(nWinding: int) float
Returns the zero sequence fault level component in kA for the specified winding of the 3-winding transformer.
- GetFaultRedAngleDeg(nWinding: int) float
Returns the red phase fault level angle in degrees for the specified winding of the 3-winding transformer.
- GetFaultYellowAngleDeg(nWinding: int) float
Returns the yellow phase fault level angle in degrees for the specified winding of the 3-winding transformer.
- GetFaultBlueAngleDeg(nWinding: int) float
Returns the blue phase fault level angle in degrees for the specified winding of the 3-winding transformer.
- GetFaultPositiveAngleDeg(nWinding: int) float
Returns the positive sequence fault level angle in degrees for the specified winding of the 3-winding transformer.
- GetFaultNegativeAngleDeg(nWinding: int) float
Returns the negative sequence fault level angle in degrees for the specified winding of the 3-winding transformer.
- GetFaultZeroAngleDeg(nWinding: int) float
Returns the zero sequence fault level angle in degrees for the specified winding of the 3-winding transformer.
- 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.
- GetCurrentAngle(nWinding: int, dOrder: float) float
Returns the current angle magnitude for the specified winding in radians for the harmonic order.
- 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.
- 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.
- GetDCLFLargestPowerMagnitudeMVA() float
Returns the highest 3-winding transformer end power in MVA.
- Returns:
The highest 3-winding transformer end power in MVA.
- Return type:
- GetDCLFLargestPowerMagnitudekVA() float
Returns the highest 3-winding transformer end power in kVA.
- Returns:
The highest 3-winding transformer end power in kVA.
- Return type:
- GetDCLFLargestRealPowerMW() float
Returns the highest 3-winding transformer end power in MW.
- Returns:
The highest 3-winding transformer end power in MW.
- Return type:
- GetDCLFLargestRealPowerkW() float
Returns the highest 3-winding transformer end power in kW.
- Returns:
The highest 3-winding transformer end power in kW.
- Return type:
- GetDCLFLossesMW() float
Returns the 3-winding transformer losses in MW.
- Returns:
The 3-winding transformer losses in MW.
- Return type:
- GetDCLFLosseskW() float
Returns the 3-winding transformer losses in kW.
- Returns:
The 3-winding transformer losses in kW.
- Return type:
- GetDCLFWindingPowerMagnitudeMVA(nWinding: int) float
Returns the MVA power flow in winding for the 3-winding transformer.
- GetDCLFWindingPowerMagnitudekVA(nWinding: int) float
Returns the kVA power flow in winding for the 3-winding transformer.