Loadflow Module¶

ERACS Loadflow engine interface. This module is crucial for many types of studies, as other calculations such as Fault and Harmonic Impedance depend on steady-state results produced by Loadflow.

class TEracsLoadflow¶

Low-level implementation of the Loadflow interface. All low-level methods in this class interact directly with the DLL procedures.

Inherits: Calculations.TEracsModule.

SetupCalculation(ASetupSimple)¶

The first method to call in the Loadflow DLL. It passes all required calculation parameters needed to run Loadflow.

Parameters: ASetupSimple (TLFSetUpData) – The setup data object, passes the Loadflow setup parameters to Loadflow.
Returns: True if successful.

LoadBusbarData(ABusbarData)¶

Loads a busbar into the Loadflow engine.

Parameters: ABusbarData (TLFBusData) – The busbar data.

LoadLineData(ATransmissionLineData)¶

Loads a transmission line into the Loadflow engine.

Parameters: ATransmissionLineData (TLFLineCableData) – The transmission line data.

LoadCableData(ACableData)¶

Loads a cable into the Loadflow engine.

Parameters: ACableData (TLFLineCableData) – The cable data.

LoadSeriesElementData(ASeriesElementData)¶

Loads a series element into the Loadflow engine.

Parameters: ASeriesElementData (TLFSeriesElementData) – The series element data.

LoadTapData(ATapChangerData)¶

Loads a tap changer into the Loadflow engine.

Parameters: ATapChangerData (TLFTapData) – The tap changer data.

LoadTxData(ATransformerData)¶

Loads a transformer into the Loadflow engine.

Parameters: ATransformerData (TLFTxData) – The transformer data.

LoadIndMachineData(AInductionMachineData)¶

Loads an induction machine into the Loadflow engine.

Parameters: AInductionMachineData (TLFIndMachData) – The induction machine data.

LoadSyncMachineData(ASynchronousMachineData)¶

Loads a synchronous machine into the Loadflow engine.

Parameters: ASynchronousMachineData (TLFSyncMachData) – The synchronous machine data.

LoadInfiniteGeneratorData(AInfiniteGeneratorData)¶

Loads an infinite generator/grid infeed into the Loadflow engine.

Parameters: AInfiniteGeneratorData (TLFInfGenData) – The infinite generator data.

LoadShuntData(AShuntData)¶

Loads a shunt connected load into the Loadflow engine.

Parameters: AShuntData (TLFShuntData) – The shunt data.

LoadBusSectionData(ABusSectionData)¶

Loads a bus section into the Loadflow engine.

Parameters: ABusSectionData (TLFBusSectionData) – The bus section data.

GetTDFBlock(ATDFBlockObject)¶

The TDF block is generated from the Loadflow module, and is used to quickly and easily pass data onto other dependent calculation modules after running Loadflow. This method loads the TDF block from memory.

Parameters: ATDFBlockObject (TEracsTdfBlock) – The TDF block to populate with data.

DisposeTDFBlock()¶: Dispose the TDF block which was loaded up from memory.

GetFileNames(AOutParameterList)¶

Parameters: AOutParameterProperties (list) – This argument acts as an out parameter. An empty list should be passed in, and the various file names will be appended to the list [lstResults, cdResults, cdData].

class TEracsLoadflowEasy¶

High-level implementation of the Loadflow interface. All methods interact with the low-level class and NOT the DLL procedures directly.

Inherits: Calculations.TEracsEasy.

ProgressSteps¶

The amount of steps which make up the progress counter.

Type: Integer.
Writable: False.

TdfBlock¶

The TDF block generated from Loadflow and needed for Fault, Harmonic Impedance and other Loadflow-dependent calculation modules.

Type: TEracsTdfBlock
Writable: False.

SummaryResults¶

Summary results from the Loadflow study.

Type: Dictionary.
Writable: False.

BusbarResults¶

Busbar results from the Loadflow study.

Type: TEracsListResult
Writable: False.

TransmissionLineResults¶

Transmission line results from the Loadflow study.

Type: TEracsListResult
Writable: False.

CableResults¶

Cable results from the Loadflow study.

Type: TEracsListResult
Writable: False.

SeriesElementResults¶

Series element results from the Loadflow study.

Type: TEracsListResult
Writable: False.

TapChangerResults¶

Tap changer results from the Loadflow study.

Type: TEracsListResult
Writable: False.

TransformerResults¶

Transformer results from the Loadflow study.

Type: TEracsListResult
Writable: False.

InductionMachineResults¶

Induction machine results from the Loadflow study.

Type: TEracsListResult
Writable: False.

SynchronousMachineResults¶

Synchronous machine results from the Loadflow study.

Type: TEracsListResult
Writable: False.

GridInfeedResults¶

Grid infeed results from the Loadflow study.

Type: TEracsListResult
Writable: False.

ShuntResults¶

Shunt results from the Loadflow study.

Type: TEracsListResult
Writable: False.

BusSectionResults¶

Bus section results from the Loadflow study.

Type: TEracsListResult
Writable: False.

CsvDataFileName¶

CSV data file path and name, generated from Loadflow.

Type: String.
Writable: False.

BaseMva¶

The base MVA Loadflow parameter to be passed in when setting up.

Type: Float.
Writable: True.

BaseFrequency¶

The base frequency (Hz) Loadflow parameter to be passed in when setting up.

Type: Float.
Writable: True.

ConvergenceTolerance¶

The convergence tolerance (pu) Loadflow parameter to be passed in when setting up.

Type: Float.
Writable: True.

NumberOfIterations¶

The number of iterations Loadflow parameter to be passed in when setting up.

Type: Integer.
Writable: True.

OverloadThreshold¶

The overload threshold (pu) Loadflow parameter to be passed in when setting up.

Type: Float.
Writable: True.

PMultiplier¶

The shunt real power multiplier Loadflow parameter to be passed in when setting up.

Type: Float.
Writable: True.

QMultiplier¶

The shunt reactive power multiplier Loadflow parameter to be passed in when setting up.

Type: Float.
Writable: True.

TapSelector¶

The tap selector Loadflow parameter to be passed in when setting up.

Type: Integer.
Writable: True.

BusLowVoltLimit¶

The bus lower voltage limit Loadflow parameter to be passed in when setting up.

Type: Float.
Writable: True.

BusHighVoltLimit¶

The bus upper voltage limit Loadflow parameter to be passed in when setting up.

Type: Float.
Writable: True.

ClearResults()¶: Clears all Loadflow results ready for the next Loadflow study. This clears the lists but keeps a reference to the (now) empty list.

SetData(AEracsDataObject)¶

This method overrides the setter method in TEracsEasy, calls the parent class method, and sets the values of the study properties if HeaderRecords and LoadflowRecords aren’t empty.

Parameters: AEracsDataObject (TEracsData) – The data object to be assigned to the internal Data attribute.

RunCalc()¶: The main method for running a Loadflow study. RunCalc will run a Loadflow study using the _Data object and the Loadflow object.

Loadflow Module¶

ERACS Python Interface

Navigation