Fault Module
Fault calculation module exposes classes capable of running ERACS Fault studies.
This module only supports running single-fault studies, and not fault surveys.
However, a fault survey can be mimicked by running multiple single-fault studies.
The MultiFault
unit can help with this.
- class TEracsFault
Low-level implementation of the Fault interface. All methods in this class provide low-level functionality involving direct interactions with the DLL. Contains minimal logic and safety checks.
- property VersionNumber
Version number of the calculation module.
- Type
str.
- Writable
False.
- property ProgramNumber
Program number of the calculation.
- Type
int.
- Writable
False.
- Example
1 = Loadflow
- ChangeImpedance(ASeqNum, AStatorR, AReactance)
Change the impedance for a given synchronous machine.
- Parameters
ASeqNum (int) – Sequence number of machine to change impedance of.
AStatorR (float) – The stator resistance of the machine.
AReactance (float) – The transient reactance of the machine.
- Raises
TEracsArgumentError – If the arguments are of the incorrect type.
- class TEracsFaultEasy
The easy access class for Fault calculations. Provides high-level, easy-to-use methods for running a Fault study.
- property ReactOption
The reactance option for the Fault study.
- Type
int.
- Writable
True.
- property FaultType
The fault type to be applied.
- Type
int.
- Writable
True.
- property Typecode
Typecode of the target element for the fault.
- Type
int.
- Writable
True.
- property SeqNum
Sequence number for the target element for the fault.
- Type
int.
- Writable
True.
- property FaultPos
Position of fault along a cable or transmission line (between 0 and 100)
- Type
float.
- Writable
True.
- property Rph
Fault’s phase resistance
- Type
float.
- Writable
True.
- property Xph
Fault’s phase reactance
- Type
float.
- Writable
True.
- property Rgrnd
Fault’s ground resistance
- Type
float.
- Writable
True.
- property Xgrnd
Fault’s ground reactance
- Type
float.
- Writable
True.
- property IncMotor
Include motor contribution.
- Type
int.
- Writable
True.
- property BusbarResults
Busbar results of the Fault study.
- Type
- Writable
False.
- property TransmissionLineResults
Transmission line results of the Fault study.
- Type
- Writable
False.
- property CableResults
Cable results of the Fault study.
- Type
- Writable
False.
- property SeriesElementResults
Series element results of the Fault study.
- Type
- Writable
False.
- property TransformerResults
Transformer results of the Fault study.
- Type
- Writable
False.
- property InductionMachineResults
Induction Machine results of the Fault study.
- Type
- Writable
False.
- property SynchronousMachineResults
Synchronous Machine results of the Fault study.
- Type
- Writable
False.
- property GridInfeedResults
Grid Infeed results of the Fault study.
- Type
- Writable
False.
- property ShuntResults
Shunt results of the Fault study.
- Type
- Writable
False.
- property BusSectionResults
Bus Section results of the Fault study.
- Type
- Writable
False.
- property NeutralResults
Neutral Earth results of the Fault study.
- Type
- Writable
False.
- property SummaryResults
Summary results of the Fault study.
- Type
dict.
- Writable
False.
- GetResultsFromTypecode(ATypecode)
Get the list of results from the typecode provided.
- Parameters
ATypecode – The typecode.
- ClearResults()
Clear the results of the previously run Fault study.
- ResultsInXml(AXmlObject)
Use this method as a callback function for the OpenInBrowserAsSvg method in TEracsData objects. This method will append all results for Loadflow to the given XML object.
- Required
LXML Python library.
- Parameters
AXmlObject – The XML object which should be a <results> element, so that <loadflow>…</> results may be appended.
- Returns
None, it is appending to the XML object.