IscGridInfeed

The IscGridInfeed class provides access to an IPSA grid infeed, to set and get data values and to retrieve load flow and fault level results.

Field Values

IscGridInfeed Field Values

Type

Field Name

Description

Integer

FromUID

Gets the unique ID for busbar.

String

BusName

Gets the busbar name.

String

Name

Gets the grid infeed name.

Integer

Status

Status:

  • 0 = Switched in

  • -1 = Switched out

Float

VoltPU

Per unit voltage target.

Float

GenMW

Generated real power.

Float

GenMVAr

Generated reactive power.

Integer

ProfileUID

Gets or sets the profile, ProfileUID, to be applied to the universal machine.

Float

PeakLLL

Peak asymmetric three phase fault contribution in MVA.

Float

RMSLLL

RMS three phase fault contribution in MVA at the break time specified by Tbreak.

Float

X2RLLL

Three phase X / R ratio determining the DC decay. A single exponential decay is modelled.

Float

PeakLG

Peak asymmetric single phase to ground fault contribution in MVA.

Float

RMSLG

RMS single phase to ground contribution in MVA at the break time specified by Tbreak.

Float

Tac

AC decay time constant for three phase faults, in seconds.

Float

Tbreak

RMS fault time in seconds.

IscGridInfeed Class

class ipsa.IscGridInfeed

Provides access to an IPSA grid infeed.

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

SetHarmonicR(dictHarmonicData: Dict[float, float]) → None

Sets the values for the harmonic resistance of the grid infeed.

Parameters:

dictHarmonicData (dict(float,float)) – Dictionary in the following format: {double dHarmonicOrder:double dHarmonicImpedance, …} where dHarmonicImpedance is a value specifying the harmonic resistance at the frequency given by the harmonic order dHarmonicOrder. Up to 120 different orders may be specified in each grid infeed.

SetHarmonicX(dictHarmonicData: Dict[float, float]) → None

Sets the values for the harmonic reactance of the grid infeed.

Parameters:

dictHarmonicData (dict(float,float)) – Dictionary in the following format: {double dHarmonicOrder:double dHarmonicImpedance, …} where dHarmonicImpedance is a value specifying the harmonic resistance at the frequency given by the harmonic order dHarmonicOrder. Up to 120 different orders may be specified in each grid infeed.

GetVoltageMagnitudePU() → float

Returns the generator voltage magnitude in per unit.

Returns:

The generator voltage magnitude in per unit.

Return type:

float

GetVoltageAngleRad() → float

Returns the voltage angle in radians.

Returns:

The voltage angle.

Return type:

float

GetVoltageAngleDeg() → float

Returns the voltage angle in degrees.

Returns:

The voltage angle.

Return type:

float

GetPowerMagnitudeMVA() → float

Returns the generator output in MVA.

Returns:

The generator output in MVA.

Return type:

float

GetPowerMagnitudekVA() → float

Returns the generator output in kVA.

Returns:

The generator output in kVA.

Return type:

float

GetRealPowerMW() → float

Returns the generator output in MW.

Returns:

The generator output in MW.

Return type:

float

GetReactivePowerMVAr() → float

Returns the generator output in MVAr.

Returns:

The generator output in MVAr.

Return type:

float

GetRealPowerkW() → float

Returns the generator output in kW.

Returns:

The generator output in kW.

Return type:

float

GetReactivePowerkVAr() → float

Returns the generator output in kVAr.

Returns:

The generator output in kVAr.

Return type:

float

GetFaultRedComponentMVA() → float

Returns the red phase component of fault level in MVA.

Returns:

The red phase component of fault level in MVA.

Return type:

float

GetFaultYellowComponentMVA() → float

Returns the yellow phase component of fault level in MVA.

Returns:

The yellow phase component of fault level in MVA.

Return type:

float

GetFaultBlueComponentMVA() → float

Returns the blue phase component of fault level in MVA.

Returns:

The blue phase component of fault level in MVA.

Return type:

float

GetFaultPositiveComponentMVA() → float

Returns the positive sequence component of fault level in MVA.

Returns:

The positive sequence component of fault level in MVA.

Return type:

float

GetFaultNegativeComponentMVA() → float

Returns the negative sequence component of fault level in MVA.

Returns:

The negative sequence component of fault level in MVA.

Return type:

float

GetFaultZeroComponentMVA() → float

Returns the zero sequence component of fault level in MVA.

Returns:

The zero sequence component of fault level in MVA.

Return type:

float

GetDCLFRealPowerMW() → float

Returns the generator output in MW.

Returns:

The generator output in MW.

Return type:

float

GetDCLFRealPowerkW() → float

Returns the generator output in kW.

Returns:

The generator output in kW.

Return type:

float