EvtSym attributesPowerFactory Synchronous Machine Event
Every attribute of the PowerFactory Synchronous Machine Event (EvtSym): 16 event parameters, with units and meaning. Copy a name into GetAttribute or SetAttribute.
What EvtSym is
A synchronous machine event: at a set time of a simulation it adds mechanical torque to a synchronous machine, changes its maximum apparent power, or takes some of its parallel machines out.
- Class
EvtSym, event class- PowerFactory name
- Synchronous Machine Event
- Attributes
- 16 event parameters
Most used EvtSym attributes
| Attribute | Unit | Description | Where |
|---|---|---|---|
p_target | · | Synchronous Machine | event data |
time | s | Execution time (absolute) | event data |
addmt | p.u. | Additional Torqueadditional torque | event data |
newS | %sgn | Maximal Apparent Power | event data |
outNgnum | · | Machine on Outageparallel machines on outage | event data |
Read and write EvtSym 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
gen = app.GetCalcRelevantObjects("*.ElmSym")[0]
ev = events.CreateObject("EvtSym", "My synchronous machine event")
ev.SetAttribute("p_target", gen)
app.SetAttributeModeInternal(1) # write the time in seconds, whatever unit the project shows
ev.SetAttribute("time", 1.0)
app.SetAttributeModeInternal(0)
ev.SetAttribute("addmt", 0.1) # additional torque, p.u.- 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.
EvtSym 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) |
outNgnum | · | Machine on Outage |
time | s | Execution time (absolute) |
addmt | p.u. | Additional Torque |
newS | %sgn | Maximal Apparent Power |
tDateTime | · | Execution Time |
p_target | · | Synchronous MachineObject: ElmSym* |
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) |