EvtTap attributesPowerFactory Tap Event
Every attribute of the PowerFactory Tap Event (EvtTap): 16 event parameters, with units and meaning. Copy a name into GetAttribute or SetAttribute.
What EvtTap is
A tap event: it moves the tap of a transformer or a shunt at a set time of a simulation.
- Class
EvtTap, event class- PowerFactory name
- Tap Event
- Attributes
- 16 event parameters
Most used EvtTap attributes
| Attribute | Unit | Description | Where |
|---|---|---|---|
p_target | · | Shunt or Transformer | event data |
time | s | Execution time (absolute) | event data |
ntap | · | Tap | event data |
Read and write EvtTap 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
trafo = app.GetCalcRelevantObjects("*.ElmTr2")[0]
ev = events.CreateObject("EvtTap", "My tap event")
ev.SetAttribute("p_target", trafo)
app.SetAttributeModeInternal(1) # write the time in seconds, whatever unit the project shows
ev.SetAttribute("time", 1.0)
app.SetAttributeModeInternal(0)
ev.SetAttribute("ntap", 2) # tap position- 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.
EvtTap 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_tap | · | Tap Action |
ntap | · | Tap |
bus | · | for Tap at |
time | s | Execution time (absolute) |
tDateTime | · | Execution Time |
p_target | · | Shunt or TransformerObject: ElmShnt,ElmTr2,ElmTr2n,ElmTr3,ElmTr4,ElmTrmult,ElmVoltreg |
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) |