IscConverter

The IscConverter class provides access to an AC/DC Converter, to set and get data values and to retrieve load flow results.

Field Values

IscConverter Field Values

Type

Field Name

Description

Integer

FromUID

Gets the unique ID of the sending busbar.

Integer

ToUID

Gets the unique ID of the receiving busbar.

String

FromBusName

Gets the sending busbar name.

String

ToBusName

Gets the receiving busbar name.

String

Name

Gets the converter name.

Integer

Status

Status of converter:

  • 0 = Converter is switched in.

  • 1 = Converter is connected but only used for harmonic analysis.

  • -1 = Converter is switched out.

Integer

Type

The type of converter:

  • 0 = Thyristor or line commuted converter

  • 51 = PWM or voltage source converter

Float

DCPowerMW

Gets and sets the DC power in MW.

Float

DCVoltagePU

Gets and sets the DC terminal voltage in per unit.

Float

ACReactivePowerMVAr

Gets and sets the AC reactive power in MVAr.

Float

PowerFactor

Returns the operating power factor.

Float

TransEqReactancePU

Gets and sets the internal transformer reactance in per unit.

Float

TransOperateTapPC

Gets and sets the operating tap position of the internal transformer in percent.

Float

MinTapPC

Gets and sets the minimum tap position of the internal transformer in percent.

Float

TapStepPC

Gets and sets the tap step of the internal transformer in percent.

Float

MaxTapPC

Gets and sets the maximum tap position of the internal transformer in percent.

Integer

PulseNumber

Gets and sets the pulse number of the converter, should be either 6, 12, 24 or 48.

Integer

NumParaBridges

Gets and sets the number of parallel bridges.

Float

CommutateReactPU

Gets and sets the commutation reactance in per unit.

Float

MaxACCurrentPU

Gets and sets the maximum AC current trip limit in per unit.

Float

VoltRatio

Gets and sets the voltage ratio of the internal converter transformer.

Float

FilterResisPU

Gets and sets the filter resistance in per unit.

Float

FilterInductPU

Gets and sets the filter inductance in per unit.

Float

DCEquivCapPU

Gets and sets the DC side capacitance in per unit.

Float

MinFireAngleDeg

Gets and sets the minimum firing angle in degrees.

Float

MaxDCCurrentPU

Gets and sets the maximum DC current limit in per unit.

IscConverter Class

class ipsa.IscConverter

Provides access to an AC/DC Converter.

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

GetACRealPowerMW() float

Returns the AC real power output of the converter in MW.

Returns:

The AC real power output of the converter in MW.

Return type:

float

GetACRealPowerkW() float

Returns the AC real power output of the converter in kW.

Returns:

The AC real power output of the converter in kW.

Return type:

float

GetACReactivePowerMVAr() float

Returns the AC reactive power output of the converter in MVAr.

Returns:

The AC reactive power output of the converter in MVAr.

Return type:

float

GetACReactivePowerkVAr() float

Returns the AC reactive power output of the converter in kVAr.

Returns:

The AC reactive power output of the converter in kVAr.

Return type:

float

GetACTotalPowerMVA() float

Returns the total AC output power of the converter in MVA.

Returns:

The total AC output power of the converter in MVA.

Return type:

float

GetACTotalPowerkVA() float

Returns the total AC output power of the converter in kVA.

Returns:

The total AC output power of the converter in kVA.

Return type:

float

GetACCurrentkA() float

Returns the AC current of the converter in kA.

Returns:

The AC current of the converter in kA.

Return type:

float

GetDCRealPowerMW() float

Returns the DC real power output of the converter in MW.

Returns:

The DC real power output of the converter in MW.

Return type:

float

GetDCRealPowerkW() float

Returns the DC real power output of the converter in kW.

Returns:

The DC real power output of the converter in kW.

Return type:

float

GetDCTotalPowerMVA() float

Returns the total DC output power of the converter in MVA.

Returns:

The total DC output power of the converter in MVA.

Return type:

float

GetDCTotalPowerkVA() float

Returns the total DC output power of the converter in kVA.

Returns:

The total DC output power of the converter in kVA.

Return type:

float

GetDCCurrentkA() float

Returns the DC current of the converter in kA.

Returns:

The DC current of the converter in kA.

Return type:

float

GetTapPC() float

Returns the operating tap setting of the converter transformer in percentage of nominal.

Returns:

The operating tap setting of the converter transformer in percentage of nominal.

Return type:

float

GetFundamentalEMFMagnitude() float

Returns the fundamental EMF magnitude of the converter.

Returns:

The fundamental EMF magnitude of the converter.

Return type:

float

GetFundamentalEMFAngle() float

Returns the fundamental EMF angle of the converter.

Returns:

The fundamental EMF angle of the converter.

Return type:

float

GetModulationIndex() float

Returns the modulation index of the converter.

Returns:

The modulation index of the converter.

Return type:

float