EvtShc attributesPowerFactory Short-Circuit Event
Every attribute of the PowerFactory Short-Circuit Event (EvtShc): 28 event parameters, with units and meaning. Copy a name into GetAttribute or SetAttribute.
What EvtShc is
A short-circuit event: it applies (or clears) a fault on a terminal or a line at a set time of an RMS or EMT simulation.
- Class
EvtShc, event class- PowerFactory name
- Short-Circuit Event
- Attributes
- 28 event parameters
Most used EvtShc attributes
| Attribute | Unit | Description | Where |
|---|---|---|---|
p_target | · | Objectthe terminal or line | event data |
time | s | Execution time (absolute)when, in seconds | event data |
i_shc | · | Fault Typefault type | event data |
R_f | Ohm | Resistance | event data |
X_f | Ohm | Reactance | event data |
i_clearShc | · | Clear Short-Circuit | event data |
outserv | · | Out of Service | event data |
Read and write EvtShc in Python
import powerfactory
app = powerfactory.GetApplication() # GetApplicationExt() from outside PowerFactory
inc = app.GetFromStudyCase("ComInc")
events = inc.GetAttribute("p_event") # the event list the simulation reads
bus = app.GetCalcRelevantObjects("*.ElmTerm")[0]
ev = events.CreateObject("EvtShc", "My short-circuit event")
ev.SetAttribute("p_target", bus)
app.SetAttributeModeInternal(1) # write the time in seconds, whatever unit the project shows
ev.SetAttribute("time", 1.0)
app.SetAttributeModeInternal(0)
ev.SetAttribute("i_shc", 0) # 0 three-phase, 1 two-phase, 2 single-phase to ground, 3 two-phase to ground, 4 clears the fault- Times are written in the unit the project shows (some show milliseconds);
SetAttributeModeInternal(1)makes it seconds. A fault is cleared by a secondEvtShcwithi_shc4:i_clearShcdoes not clear it in an RMS or EMT run.
EvtShc event parameters
Set these on the event before the simulation runs. Names are typed without the e: shown in variable lists.
| Attribute | Unit | Description |
|---|---|---|
outserv | · | Out of Service |
mtime | min | Execution time (absolute, in minutes) |
hrtime | h | Execution time (absolute, in hours) |
i_shc | · | Fault Type |
i_p2psc | · | Phases |
i_pspgf | · | Phase |
i_p2pgf | · | Phases |
ZfaultInp | · | Input |
i_clearShc | · | Clear Short-Circuit |
time | s | Execution time (absolute) |
R_f | Ohm | Resistance |
X_f | Ohm | Reactance |
L_f | mH | Inductance |
shcLocation | % | Fault Location |
tDateTime | · | Execution Time |
p_target | · | Object |
p_from | · | Event defined byObject: Elm* |
dtime | s | Execution time (relative to now) |
tact | s | Now (current simulation time) |
dmtime | min | Execution time (relative to now, in minutes) |
mtact | min | Now (current simulation time, in minutes) |
dhrtime | h | Execution time (relative to now, in hours) |
hrtact | h | Now (current simulation time, in hours) |
Z_f | Ohm | Impedance |
ang_f | deg | Angle |
X2R_f | · | X/R ratio |
R2X_f | · | R/X ratio |
effectedLne | · | Affected lineObject: ElmLne |