ElmTerm attributesPowerFactory Terminal
Every attribute of the PowerFactory Terminal (ElmTerm): 117 input parameters and 391 result variables, with units and meaning. Copy a name into GetAttribute or SetAttribute.
What ElmTerm is
A terminal: a busbar, a junction node or an internal node. Node results are read here: voltage magnitude and angle after a load flow, fault levels after a short circuit, frequency during an RMS simulation.
- Class
ElmTerm, element class- PowerFactory name
- Terminal
- Attributes
- 117 input parameters and 391 result variables, in 6 calculations
Most used ElmTerm attributes
| Attribute | Unit | Description | Where |
|---|---|---|---|
m:u | p.u. | Voltage, Magnitudevoltage, p.u. | Load flow |
m:Ul | kV | Line-Line Voltage, Magnitudeline-line voltage, kV | Load flow |
m:phiu | deg | Voltage, Anglevoltage angle | Load flow |
m:du | % | Voltage Deviationdeviation from nominal | Load flow |
uknom | kV | Line-Linenominal voltage | input data |
m:Ikss | kA | Initial Short-Circuit Currentinitial short-circuit current | Short-circuit |
m:Skss | MVA | Initial Short-Circuit Power | Short-circuit |
m:ip | kA | Peak Short-Circuit Currentpeak short-circuit current | Short-circuit |
m:fehz | Hz | Electrical Frequencyfrequency (RMS simulation) | RMS simulation |
outserv | ยท | Out of Service | input data |
iUsage | ยท | Usagebusbar, junction or internal node | input data |
Read and write ElmTerm in Python
import powerfactory
app = powerfactory.GetApplication() # GetApplicationExt() from outside PowerFactory
app.GetFromStudyCase("ComLdf").Execute() # results exist after a calculation
for bus in app.GetCalcRelevantObjects("*.ElmTerm"):
u = bus.GetAttribute("m:u") # Voltage, Magnitude, p.u.
ul = bus.GetAttribute("m:Ul") # Line-Line Voltage, Magnitude, kV
print(bus.loc_name, u, ul)
bus = app.GetCalcRelevantObjects("*.ElmTerm")[0]
bus.SetAttribute("outserv", 1) # take the terminal out of service
- An input parameter is read and written with or without its
e:prefix:GetAttribute("outserv")andGetAttribute("e:outserv")give the same value. - RMS and EMT variables change over time: record them in a results object (
ElmRes) to read the whole curve.GetAttributeafter a run gives the value at the last time step.
- Input parameters117
- Load flow results80
- Short-circuit results164
- RMS simulation results60
- EMT simulation results28
- DC load flow results17
- Optimal power flow results42
- Basic data64
ElmTerm input parameters
The element data, as typed in GetAttribute and SetAttribute (the e: prefix is optional). Setting one changes the model.
| Attribute | Unit | Description |
|---|---|---|
loc_name | ยท | Name |
chr_name | ยท | Characteristic Name |
for_name | ยท | Foreign Key |
dat_src | ยท | Data source |
sernum | ยท | Serial Number |
commissionDate | ยท | Commissioning Date |
appr_modby | ยท | Modified by |
Electrodes | ยท | Electrode configuration |
outserv | ยท | Out of Service |
constr | ยท | Year of Construction |
appr_status | ยท | Status |
systype | ยท | System Type |
iminus | ยท | DC-Polarity |
iperfect | ยท | Ideal component |
iOPFCvmax | ยท | Upper Voltage Limit |
iOPFCvmin | ยท | Lower Voltage Limit |
isSoftConstr | ยท | Soft constraint |
isSoftConstrNonLin | ยท | Penalty costs for soft constraints |
iTopoPrio | ยท | Priority |
iUsage | ยท | Usage |
iPriority | ยท | Priority for connectivity tracing |
iBayEnd | ยท | Bay end |
iEarth | ยท | Earthed |
ivpriority | ยท | Priority |
iAccessLoc | ยท | Accessible Location |
iSubstatDef | ยท | Equipment Data |
DcBoxType | ยท | Enclosure type |
iBoxed | ยท | Enclosure |
uknom | kV | Line-Line |
vmax | p.u. | Upper Voltage Limit |
vmin | p.u. | Lower Voltage Limit |
vtarget | p.u. | Target Voltage |
dvmax | % | Delta V max |
dvmin | % | Delta V min |
GPSlat | deg | Latitude / Northing |
GPSlon | deg | Longitude / Easting |
scalingFacSoftConstrCost | ยท | Cost scaling factor |
AccessTime | min | First manual switch action after the fault |
LocAccTime | min | After a switch action at another busbar |
CondGap | mm | Conductor gap |
Xfactor | ยท | Distance factor |
WorkDist | mm | Working distance |
BoxWidth | mm | Width |
BoxHeight | mm | Height |
BoxDepth | mm | Depth |
arcLength | mm | Arc length |
nFactor | ยท | Statistical correction |
dpl1 | ยท | dpl1 |
dpl2 | ยท | dpl2 |
dpl3 | ยท | dpl3 |
dpl4 | ยท | dpl4 |
dpl5 | ยท | dpl5 |
appr_modif | ยท | Modified |
desc | ยท | Description |
cimRdfId | ยท | RDF ID |
fold_id | ยท | In Folder |
typ_id | ยท | TypeObject: TypBar |
doc_id | ยท | Additional Data |
pOwner | ยท | OwnerObject: ElmOwner |
pOperator | ยท | OperatorObject: ElmOperator |
pStoch | StoTypbar | Element model |
pRating | ยท | Thermal RatingObject: IntThrating |
cubics | ยท | CubiclesObject: StaCubic |
cpHeadFold | ยท | Head Folder |
cpGrid | ยท | GridObject: ElmNet |
cpZone | ยท | ZoneObject: ElmZone |
cpArea | ยท | AreaObject: ElmArea |
cpFeed | ยท | FeederObject: ElmFeeder |
ciDist | ยท | Distance from infeed in number of buses |
ciLater | ยท | Lateral Index |
ciDistRoot | ยท | Distance from first infeed in number of buses |
ciDistAll | ยท | Distance from infeed in number of buses including switches |
ciDistAllRoot | ยท | Distance from first infeed in number of buses including switches |
cpOwner | ยท | OwnerObject: ElmOwner |
cpOperator | ยท | OperatorObject: ElmOperator |
cpBranch | ยท | BranchObject: ElmBranch |
cpSite | ยท | SiteObject: ElmSite |
cpSubstat | ยท | SubstationObject: ElmSubstat,ElmTrfstat |
cpMeteostat | ยท | Meteo StationObject: ElmMeteostat |
ciOutaged | ยท | Planned Outage |
ciEnergized | ยท | Energized |
ciEarthed | ยท | Earthed |
cDisplayName | ยท | Display Name |
cpSupplyTransformer | ยท | Supplying TransformerObject: ElmTr?,ElmTrmult |
cpSupplyTrfStation | ยท | Supplying Secondary SubstationObject: ElmTrfstat |
cpSupplySubstation | ยท | Supplying SubstationObject: ElmSubstat |
unknom | kV | Line-Ground |
cStatName | ยท | Station/Name |
phtech | ยท | Phase Technology |
FOR1 | 1/a | Forced Outage Rate |
FOE | h/a | Forced Outage Expectancy |
FOD | h | Forced Outage Duration |
pTypStoch | StoTypbar | Type model |
CCEarFr | 1/a | Frequency of single earth faults |
CCEarRepMu | h | Repair duration |
CCEarProb | % | Conditional probability of a second earth fault |
cPosLne | km | Position on Line |
scalingFacSoftConstrOpf | ยท | Weighting factor for soft constraint penalty |
Inom | kA | Nominal current |
Inom_a | kA | Nominal current (act.) |
Vtarget | kV | Target Voltage |
NodeName | ยท | Node Name |
UcteNodeName | ยท | Ucte Node Name |
cAccessTime | min | First manual switch action after the fault |
cLocAccTime | min | After a switch action at another busbar |
cpBay | ยท | BayObject: ElmBay |
cCondGap | mm | Conductor gap |
cXfactor | ยท | Distance factor |
cWorkDist | mm | Working distance |
cElectrodes | ยท | Electrode configuration |
cBoxWidth | mm | Width |
cBoxHeight | mm | Height |
cBoxDepth | mm | Depth |
cDcBoxType | ยท | Enclosure type |
cBoxed | ยท | Enclosure |
carcLength | mm | Arc length |
cnFactor | ยท | Statistical correction |
ElmTerm load flow results
Read after ComLdf with GetAttribute. m: currents, voltages and powers.
| Attribute | Unit | Description |
|---|---|---|
m:ur | p.u. | Voltage, Real Part |
m:ui | p.u. | Voltage, Imaginary Part |
m:u | p.u. | Voltage, Magnitude |
m:upc | % | Voltage, Magnitude |
m:du | % | Voltage Deviation |
m:U | kV | Line-Ground Voltage, Magnitude |
m:phiu | deg | Voltage, Angle |
m:phiurel | deg | Voltage, Relative Angle |
m:Ul | kV | Line-Line Voltage, Magnitude |
m:u1 | p.u. | Voltage, Magnitude |
m:u1pc | % | Voltage, Magnitude |
m:u1r | p.u. | Positive-Sequence Voltage, Real Part |
m:u1i | p.u. | Positive-Sequence Voltage, Imaginary Part |
m:Pgen | MW | Generation, Active Power |
m:Qgen | Mvar | Generation, Reactive Power |
m:Pmot | MW | Motor Load, Active Power |
m:Qmot | Mvar | Motor Load, Reactive Power |
m:Pload | MW | General Load, Active Power |
m:Qload | Mvar | General Load, Reactive Power |
m:Pcomp | MW | Compensation (Losses) |
m:Qcomp | Mvar | Compensation |
m:Pnet | MW | External Networks, Active Power |
m:Qnet | Mvar | External Networks, Reactive Power |
m:Pflow | MW | Power Flow, Active Power |
m:Qflow | Mvar | Power Flow, Reactive Power |
m:Pout | MW | Outgoing Flow, Active Power |
m:Qout | Mvar | Outgoing Power, Reactive Power |
m:Sout | MVA | Outgoing Power, Apparent Power |
m:cosphiout | ยท | Outgoing Power, Power Factor |
m:Pbalance | MW | Active Power Balance (=0) |
m:Qbalance | Mvar | Reactive Power Balance (=0) |
m:LossPdown | MW | Losses, downstream |
m:LossQdown | Mvar | Losses, downstream (Reactive Power) |
m:LossPdownload | MW | Load losses, downstream |
m:LossQdownload | Mvar | Load losses, downstream |
m:LossPdownnoload | MW | No load losses, downstream |
m:LossQdownnoload | Mvar | No load losses, downstream |
m:du_feed | % | Difference from voltage at start of feeder |
m:Inom | kA | Nominal Current |
m:Imax | kA | Max. Current |
m:loading | % | Loading |
m:idxImax | ยท | Index of section with max. current |
m:ur:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Ground Voltage, Real Part |
m:ui:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Ground Voltage, Imaginary Part |
m:u:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Ground Voltage, Magnitude |
m:upc:Aper phase :A, :B, :C, unbalanced only | % | Line-Ground Voltage, Magnitude |
m:du:Aper phase :A, :B, :C, unbalanced only | % | Voltage Deviation |
m:U:Aper phase :A, :B, :C, unbalanced only | kV | Line-Ground Voltage, Magnitude |
m:phiu:Aper phase :A, :B, :C, unbalanced only | deg | Line-Ground Voltage, Angle |
m:ul:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Line Voltage, Magnitude |
m:ulpc:Aper phase :A, :B, :C, unbalanced only | % | Line-Line Voltage, Magnitude |
m:Ul:Aper phase :A, :B, :C, unbalanced only | kV | Line-Line Voltage, Magnitude |
m:phiul:Aper phase :A, :B, :C, unbalanced only | deg | Line-Line Voltage, Angle |
m:u0 | p.u. | Zero-Sequence Voltage, Magnitude |
m:U0 | kV | Zero-Sequence Voltage, Magnitude |
m:U0x3 | kV | 3*U0 |
m:phiu0 | deg | Zero-Sequence Voltage, Angle |
m:U1 | kV | Line-Ground Positive-Sequence Voltage, Magnitude |
m:phiu1 | deg | Positive-Sequence Voltage, Angle |
m:u2 | p.u. | Negative-Sequence Voltage, Magnitude |
m:U2 | kV | Line-Ground Negative-Sequence Voltage, Magnitude |
m:phiu2 | deg | Negative-Sequence Voltage, Angle |
m:U1l | kV | Line-Line Positive-Sequence Voltage, Magnitude |
m:U2l | kV | Line-Line Negative-Sequence Voltage, Magnitude |
m:uln:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Neutral Voltage, Magnitude |
m:Uln:Aper phase :A, :B, :C, unbalanced only | kV | Line-Neutral Voltage, Magnitude |
m:phiuln:Aper phase :A, :B, :C, unbalanced only | deg | Line-Neutral Voltage, Angle |
m:un | p.u. | Neutral-Ground Voltage, Magnitude |
m:Un | kV | Neutral-Ground Voltage, Magnitude |
m:phiun | deg | Neutral-Ground Voltage, Angle |
m:upht:Aper phase :A, :B, :C, unbalanced only | p.u. | Phase Technology dependent Voltage, Magnitude |
m:Upht:Aper phase :A, :B, :C, unbalanced only | kV | Phase Technology dependent Voltage, Magnitude |
m:um | p.u. | Average-Voltage, Magnitude |
m:Um | kV | Average-Voltage, Magnitude |
m:uphtmin | p.u. | Minimum of Phase Technology dependent Voltage, Magnitude |
m:uphtmax | p.u. | Maximum of Phase Technology dependent Voltage, Magnitude |
m:ubfac | % | Unbalance Factor |
m:ImaxPh:Aper phase :A, :B, :C, unbalanced only | kA | Max. Current (per phase) |
m:loadingPh:Aper phase :A, :B, :C, unbalanced only | % | Loading |
m:idxImaxPh:Aper phase :A, :B, :C, unbalanced only | ยท | Index of section with max. current (per phase) |
ElmTerm short-circuit results
Read after ComShc with GetAttribute. m: currents, voltages and powers.
| Attribute | Unit | Description |
|---|---|---|
m:ur | p.u. | Voltage, Real Part |
m:ui | p.u. | Voltage, Imaginary Part |
m:u | p.u. | Voltage, Magnitude |
m:upc | % | Voltage, Magnitude |
m:du | % | Voltage Deviation |
m:U | kV | Line-Ground Voltage, Magnitude |
m:phiu | deg | Voltage, Angle |
m:Ul | kV | Line-Line Voltage, Magnitude |
m:u1 | p.u. | Voltage, Magnitude |
m:u1pc | % | Voltage, Magnitude |
m:u1r | p.u. | Positive-Sequence Voltage, Real Part |
m:u1i | p.u. | Positive-Sequence Voltage, Imaginary Part |
m:Ikss | kA | Initial Short-Circuit Current |
m:I | kA | Short-Circuit Current |
m:phii | deg | Phase Current, Angle |
m:Skss | MVA | Initial Short-Circuit Power |
m:ip | kA | Peak Short-Circuit Current |
m:Ib | kA | Short-Circuit Breaking Current |
m:Sb | MVA | Short-Circuit Breaking Power |
m:idc | kA | Decaying Component |
m:Ith | kA | Thermal equivalent Short-Circuit Current |
m:R1toX1 | ยท | R1/X1 ratio (Zk") |
m:X1toR1 | ยท | X1/R1 ratio (Zk") |
m:R | Ohm | Short-Circuit Impedance, Real Part |
m:X | Ohm | Short-Circuit Impedance, Imaginary Part |
m:Z | Ohm | Short-Circuit Impedance, Magnitude |
m:phiz | deg | Short-Circuit Impedance, Angle |
m:urpref | p.u. | Pre-fault Voltage, Real Part |
m:uipref | p.u. | Pre-fault Voltage, Imaginary Part |
m:upref | p.u. | Pre-fault Voltage, Magnitude |
m:uprefpc | % | Pre-fault Voltage, Magnitude |
m:Upref | kV | Line-Ground Pre-fault Voltage, Magnitude |
m:Ulpref | kV | Line-Line Pre-fault Voltage, Magnitude |
m:phiupref | deg | Pre-fault Voltage, Angle |
m:phiui | deg | Angle between Voltage and Current |
m:Ithload | % | Loading, Thermal equivalent Current |
m:Ipload | % | Loading, Peak Short-Circuit Current |
m:Ithrtk | kA | Rated Short-Time Current (Tk) |
m:XtoR | ยท | X/R ratio (peak) |
m:RtoX | ยท | R/X ratio (peak) |
m:XtoR_b | ยท | X/R ratio (dc) |
m:RtoX_b | ยท | R/X ratio (dc) |
m:fctof_b | ยท | Equivalent Frequency fc/f (dc) |
m:rSbase | p.u. | Short-Circuit Impedance, Real Part |
m:xSbase | p.u. | Short-Circuit Impedance, Imaginary Part |
m:zSbase | p.u. | Short-Circuit Impedance, Magnitude |
m:Tn | ms | Grid Time Constant |
m:Ik | kA | Steady-State Short-Circuit Current |
m:cfac | ยท | Voltage Factor |
m:Iasy | kA | Asymmetrical Breaking Current |
m:ur:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Ground Voltage, Real Part |
m:ui:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Ground Voltage, Imaginary Part |
m:u:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Ground Voltage, Magnitude |
m:upc:Aper phase :A, :B, :C, unbalanced only | % | Line-Ground Voltage, Magnitude |
m:du:Aper phase :A, :B, :C, unbalanced only | % | Voltage Deviation |
m:U:Aper phase :A, :B, :C, unbalanced only | kV | Line-Ground Voltage, Magnitude |
m:phiu:Aper phase :A, :B, :C, unbalanced only | deg | Line-Ground Voltage, Angle |
m:ul:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Line Voltage, Magnitude |
m:ulpc:Aper phase :A, :B, :C, unbalanced only | % | Line-Line Voltage, Magnitude |
m:Ul:Aper phase :A, :B, :C, unbalanced only | kV | Line-Line Voltage, Magnitude |
m:phiul:Aper phase :A, :B, :C, unbalanced only | deg | Line-Line Voltage, Angle |
m:u0 | p.u. | Zero-Sequence Voltage, Magnitude |
m:U0 | kV | Zero-Sequence Voltage, Magnitude |
m:U0x3 | kV | 3*U0 |
m:phiu0 | deg | Zero-Sequence Voltage, Angle |
m:U1 | kV | Line-Ground Positive-Sequence Voltage, Magnitude |
m:phiu1 | deg | Positive-Sequence Voltage, Angle |
m:u2 | p.u. | Negative-Sequence Voltage, Magnitude |
m:U2 | kV | Line-Ground Negative-Sequence Voltage, Magnitude |
m:phiu2 | deg | Negative-Sequence Voltage, Angle |
m:U1l | kV | Line-Line Positive-Sequence Voltage, Magnitude |
m:U2l | kV | Line-Line Negative-Sequence Voltage, Magnitude |
m:uln:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Neutral Voltage, Magnitude |
m:Uln:Aper phase :A, :B, :C, unbalanced only | kV | Line-Neutral Voltage, Magnitude |
m:phiuln:Aper phase :A, :B, :C, unbalanced only | deg | Line-Neutral Voltage, Angle |
m:un | p.u. | Neutral-Ground Voltage, Magnitude |
m:Un | kV | Neutral-Ground Voltage, Magnitude |
m:phiun | deg | Neutral-Ground Voltage, Angle |
m:upht:Aper phase :A, :B, :C, unbalanced only | p.u. | Phase Technology dependent Voltage, Magnitude |
m:Upht:Aper phase :A, :B, :C, unbalanced only | kV | Phase Technology dependent Voltage, Magnitude |
m:Ikss:Aper phase :A, :B, :C, unbalanced only | kA | Initial Short-Circuit Current |
m:I:Aper phase :A, :B, :C, unbalanced only | kA | Short-Circuit Current |
m:phii:Aper phase :A, :B, :C, unbalanced only | deg | Phase Current, Angle |
m:Skss:Aper phase :A, :B, :C, unbalanced only | MVA | Initial Short-Circuit Power |
m:Skssx3:Aper phase :A, :B, :C, unbalanced only | MVA | 3*Initial Short-Circuit Power |
m:ip:Aper phase :A, :B, :C, unbalanced only | kA | Peak Short-Circuit Current |
m:Ib:Aper phase :A, :B, :C, unbalanced only | kA | Short-Circuit Breaking Current |
m:Sb:Aper phase :A, :B, :C, unbalanced only | MVA | Short-Circuit Breaking Power |
m:Ith:Aper phase :A, :B, :C, unbalanced only | kA | Thermal equivalent Short-Circuit Current |
m:Ithmax | kA | Max. Thermal equivalent Short-Circuit Current |
m:R0 | Ohm | Zero-Sequence Impedance, Real Part |
m:X0 | Ohm | Zero-Sequence Impedance, Imaginary Part |
m:Z0 | Ohm | Zero-Sequence Impedance, Magnitude |
m:phiz0 | deg | Zero-Sequence Impedance, Angle |
m:r0Sbase | p.u. | Zero-Sequence Impedance, Real Part |
m:x0Sbase | p.u. | Zero-Sequence Impedance, Imaginary Part |
m:z0Sbase | p.u. | Zero-Sequence Impedance, Magnitude |
m:R1 | Ohm | Positive-Sequence Impedance, Real Part |
m:X1 | Ohm | Positive-Sequence Impedance, Imaginary Part |
m:Z1 | Ohm | Positive-Sequence Impedance, Magnitude |
m:phiz1 | deg | Positive-Sequence Impedance, Angle |
m:r1Sbase | p.u. | Positive-Sequence Impedance, Real Part |
m:x1Sbase | p.u. | Positive-Sequence Impedance, Imaginary Part |
m:z1Sbase | p.u. | Positive-Sequence Impedance, Magnitude |
m:R2 | Ohm | Negative-Sequence Impedance, Real Part |
m:X2 | Ohm | Negative-Sequence Impedance, Imaginary Part |
m:Z2 | Ohm | Negative-Sequence Impedance, Magnitude |
m:phiz2 | deg | Negative-Sequence Impedance, Angle |
m:r2Sbase | p.u. | Negative-Sequence Impedance, Real Part |
m:x2Sbase | p.u. | Negative-Sequence Impedance, Imaginary Part |
m:z2Sbase | p.u. | Negative-Sequence Impedance, Magnitude |
m:R0toX0 | ยท | R0/X0 ratio (Zk") |
m:X0toR0 | ยท | X0/R0 ratio (Zk") |
m:R2toX2 | ยท | R2/X2 ratio (Zk") |
m:X2toR2 | ยท | X2/R2 ratio (Zk") |
m:R:Aper phase :A, :B, :C, unbalanced only | Ohm | Network Resistance, Line-Ground |
m:X:Aper phase :A, :B, :C, unbalanced only | Ohm | Network Reactance, Line-Ground |
m:Z:Aper phase :A, :B, :C, unbalanced only | Ohm | Network Impedance, Line-Ground |
m:phiz:Aper phase :A, :B, :C, unbalanced only | deg | Angle of Network Impedance, Line-Ground |
m:Rl:Aper phase :A, :B, :C, unbalanced only | Ohm | Network Resistance, Line-Line |
m:Xl:Aper phase :A, :B, :C, unbalanced only | Ohm | Network Reactance, Line-Line |
m:Zl:Aper phase :A, :B, :C, unbalanced only | Ohm | Network Impedance, Line-Line |
m:phizl:Aper phase :A, :B, :C, unbalanced only | deg | Angle of Network Impedance, Line-Line |
m:Rln:Aper phase :A, :B, :C, unbalanced only | Ohm | Network Resistance, Line-Neutral |
m:Xln:Aper phase :A, :B, :C, unbalanced only | Ohm | Network Reactance, Line-Neutral |
m:Zln:Aper phase :A, :B, :C, unbalanced only | Ohm | Network Impedance, Line-Neutral |
m:phizln:Aper phase :A, :B, :C, unbalanced only | deg | Angle of Network Impedance, Line-Neutral |
m:Rn | Ohm | Network Resistance, Neutral |
m:Xn | Ohm | Network Reactance, Neutral |
m:Zn | Ohm | Network Impedance, Neutral |
m:phizn | deg | Angle of Network Impedance, Neutral |
m:eff:Aper phase :A, :B, :C, unbalanced only | ยท | Earth Fault Factor |
m:X0toX1 | ยท | X0/X1 |
m:In | kA | Neutral Current, Magnitude |
m:phiin | deg | Neutral Current, Angle |
m:I0 | kA | Zero-Sequence Current, Magnitude |
m:I0x3 | kA | 3*I0 |
m:phii0 | deg | Zero-Sequence Current, Angle |
m:I1 | kA | Positive-Sequence Current, Magnitude |
m:phii1 | deg | Positive-Sequence Current, Angle |
m:I2 | kA | Negative-Sequence Current, Magnitude |
m:phii2 | deg | Negative-Sequence Current, Angle |
m:urpref:Aper phase :A, :B, :C, unbalanced only | p.u. | Pre-fault Voltage, Real Part |
m:uipref:Aper phase :A, :B, :C, unbalanced only | p.u. | Pre-fault Voltage, Imaginary Part |
m:upref:Aper phase :A, :B, :C, unbalanced only | p.u. | Pre-fault Voltage, Magnitude |
m:uprefpc:Aper phase :A, :B, :C, unbalanced only | % | Pre-fault Voltage, Magnitude |
m:Upref:Aper phase :A, :B, :C, unbalanced only | kV | Line-Ground Pre-fault Voltage, Magnitude |
m:Ulpref:Aper phase :A, :B, :C, unbalanced only | kV | Line-Line Pre-fault Voltage, Magnitude |
m:phiupref:Aper phase :A, :B, :C, unbalanced only | deg | Pre-fault Voltage, Angle |
m:phiui:Aper phase :A, :B, :C, unbalanced only | deg | Angle between Voltage and Current |
m:phiu1i1 | deg | Angle between Voltage and Current in positive sequence system |
m:phiu2i2 | deg | Angle between Voltage and Current in negative sequence system |
m:phiu0i0 | deg | Angle between Voltage and Current in zero-sequence system |
m:Ik:Aper phase :A, :B, :C, unbalanced only | kA | Steady-State Short-Circuit Current |
m:in | p.u. | Neutral Current, Magnitude |
m:i0r | p.u. | Zero-Sequence Current, Real Part |
m:i0i | p.u. | Zero-Sequence Current, Imaginary Part |
m:i0 | p.u. | Zero-Sequence Current, Magnitude |
m:i1r | p.u. | Positive-Sequence Current, Real Part |
m:i1i | p.u. | Positive-Sequence Current, Imaginary Part |
m:i1 | p.u. | Positive-Sequence Current, Magnitude |
m:i2r | p.u. | Negative-Sequence Current, Real Part |
m:i2i | p.u. | Negative-Sequence Current, Imaginary Part |
m:i2 | p.u. | Negative-Sequence Current, Magnitude |
ElmTerm rms simulation results
Read after ComInc (RMS) with GetAttribute. m: currents, voltages and powers.
| Attribute | Unit | Description |
|---|---|---|
m:ur | p.u. | Voltage, Real Part |
m:ui | p.u. | Voltage, Imaginary Part |
m:u | p.u. | Voltage, Magnitude |
m:upc | % | Voltage, Magnitude |
m:du | % | Voltage Deviation |
m:U | kV | Line-Ground Voltage, Magnitude |
m:phiu | deg | Voltage, Angle |
m:phiurel | deg | Voltage, Relative Angle |
m:Ul | kV | Line-Line Voltage, Magnitude |
m:u1 | p.u. | Voltage, Magnitude |
m:u1pc | % | Voltage, Magnitude |
m:u1r | p.u. | Positive-Sequence Voltage, Real Part |
m:u1i | p.u. | Positive-Sequence Voltage, Imaginary Part |
m:ishc | p.u. | Short-Circuit Current, magnitude |
m:Ishc | kA | Short-Circuit Current, magnitude |
m:fe | p.u. | Electrical Frequency |
m:dfehz | Hz | Deviation of the El. Frequency |
m:fehz | Hz | Electrical Frequency |
m:frnom | Hz | Nominal Frequency |
m:ishcr | p.u. | Short-Circuit Current, real |
m:ishci | p.u. | Short-Circuit Current, imag |
m:dfedt | p.u./s | Derivative of El. Frequency |
m:ur:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Ground Voltage, Real Part |
m:ui:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Ground Voltage, Imaginary Part |
m:u:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Ground Voltage, Magnitude |
m:upc:Aper phase :A, :B, :C, unbalanced only | % | Line-Ground Voltage, Magnitude |
m:du:Aper phase :A, :B, :C, unbalanced only | % | Voltage Deviation |
m:U:Aper phase :A, :B, :C, unbalanced only | kV | Line-Ground Voltage, Magnitude |
m:phiu:Aper phase :A, :B, :C, unbalanced only | deg | Line-Ground Voltage, Angle |
m:ul:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Line Voltage, Magnitude |
m:ulpc:Aper phase :A, :B, :C, unbalanced only | % | Line-Line Voltage, Magnitude |
m:Ul:Aper phase :A, :B, :C, unbalanced only | kV | Line-Line Voltage, Magnitude |
m:phiul:Aper phase :A, :B, :C, unbalanced only | deg | Line-Line Voltage, Angle |
m:u0 | p.u. | Zero-Sequence Voltage, Magnitude |
m:U0 | kV | Zero-Sequence Voltage, Magnitude |
m:U0x3 | kV | 3*U0 |
m:phiu0 | deg | Zero-Sequence Voltage, Angle |
m:U1 | kV | Line-Ground Positive-Sequence Voltage, Magnitude |
m:phiu1 | deg | Positive-Sequence Voltage, Angle |
m:u2 | p.u. | Negative-Sequence Voltage, Magnitude |
m:U2 | kV | Line-Ground Negative-Sequence Voltage, Magnitude |
m:phiu2 | deg | Negative-Sequence Voltage, Angle |
m:U1l | kV | Line-Line Positive-Sequence Voltage, Magnitude |
m:U2l | kV | Line-Line Negative-Sequence Voltage, Magnitude |
m:uln:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Neutral Voltage, Magnitude |
m:Uln:Aper phase :A, :B, :C, unbalanced only | kV | Line-Neutral Voltage, Magnitude |
m:phiuln:Aper phase :A, :B, :C, unbalanced only | deg | Line-Neutral Voltage, Angle |
m:un | p.u. | Neutral-Ground Voltage, Magnitude |
m:Un | kV | Neutral-Ground Voltage, Magnitude |
m:phiun | deg | Neutral-Ground Voltage, Angle |
m:upht:Aper phase :A, :B, :C, unbalanced only | p.u. | Phase Technology dependent Voltage, Magnitude |
m:Upht:Aper phase :A, :B, :C, unbalanced only | kV | Phase Technology dependent Voltage, Magnitude |
m:um | p.u. | Average-Voltage, Magnitude |
m:Um | kV | Average-Voltage, Magnitude |
m:ishc:Aper phase :A, :B, :C, unbalanced only | p.u. | Short-Circuit Current, magnitude |
m:Ishc:Aper phase :A, :B, :C, unbalanced only | kA | Short-Circuit Current, magnitude |
m:inshc | p.u. | Neutral Short-Circuit Current, magnitude |
m:Inshc | kA | Neutral Short-Circuit Current, magnitude |
m:ishcr:Aper phase :A, :B, :C, unbalanced only | p.u. | Short-Circuit Current, real |
m:ishci:Aper phase :A, :B, :C, unbalanced only | p.u. | Short-Circuit Current, imag |
ElmTerm emt simulation results
Read after ComInc (EMT) with GetAttribute. m: currents, voltages and powers.
| Attribute | Unit | Description |
|---|---|---|
m:u:Aper phase :A, :B, :C, unbalanced only | p.u. | Phase Voltage |
m:upc:Aper phase :A, :B, :C, unbalanced only | % | Phase Voltage |
m:U:Aper phase :A, :B, :C, unbalanced only | kV | Phase Voltage |
m:ul:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Line Voltage |
m:ulpc:Aper phase :A, :B, :C, unbalanced only | % | Line-Line Voltage |
m:Ul:Aper phase :A, :B, :C, unbalanced only | kV | Line-Line Voltage |
m:u0 | p.u. | Zero-Sequence-Voltage |
m:U0 | kV | Zero-Sequence-Voltage |
m:U0x3 | kV | 3*U0 |
m:u1 | p.u. | Voltage Phasor, Magnitude |
m:u1pc | % | Voltage Phasor, Magnitude |
m:u1r | p.u. | Voltage Phasor, Real Part |
m:u1i | p.u. | Voltage Phasor, Imaginary Part |
m:U1 | kV | Voltage Phasor, Magnitude |
m:phiu1 | deg | Voltage Phasor, Angle |
m:U1l | kV | Line-Line Voltage Phasor, Magnitude |
m:uln:Aper phase :A, :B, :C, unbalanced only | p.u. | Line-Neutral Voltage |
m:Uln:Aper phase :A, :B, :C, unbalanced only | kV | Line-Neutral Voltage |
m:un | p.u. | Neutral-Ground Voltage |
m:Un | kV | Neutral-Ground Voltage |
m:ishc:Aper phase :A, :B, :C, unbalanced only | p.u. | Short-Circuit Current |
m:Ishc:Aper phase :A, :B, :C, unbalanced only | kA | Short-Circuit Current |
m:inshc | p.u. | Neutral Short-Circuit Current, magnitude |
m:Inshc | kA | Neutral Short-Circuit Current, magnitude |
m:fe | p.u. | Electrical Frequency |
m:dfehz | Hz | Deviation of the El. Frequency |
m:fehz | Hz | Electrical Frequency |
m:frnom | Hz | Nominal Frequency |
ElmTerm dc load flow results
Read after ComLdf (DC) with GetAttribute. m: currents, voltages and powers.
| Attribute | Unit | Description |
|---|---|---|
m:u | p.u. | Voltage, Magnitude |
m:upc | % | Voltage, Magnitude |
m:U | kV | Line-Ground Voltage, Magnitude |
m:phiu | deg | Voltage, Angle |
m:phiurel | deg | Voltage, Relative Angle |
m:Ul | kV | Line-Line Voltage, Magnitude |
m:u1 | p.u. | Voltage, Magnitude |
m:Pgen | MW | Generation, Active Power |
m:Pmot | MW | Motor Load, Active Power |
m:Pload | MW | General Load, Active Power |
m:Pcomp | MW | Compensation (Losses) |
m:Pnet | MW | External Networks, Active Power |
m:Pflow | MW | Power Flow, Active Power |
m:loading | % | Max. Loading |
m:Pnom | MW | Nominal Active Power |
m:Pmax | MW | Max. Active Power |
m:idxPmax | ยท | Index of section with max. active power |
ElmTerm optimal power flow results
Read after ComOpf with GetAttribute. m: currents, voltages and powers.
| Attribute | Unit | Description |
|---|---|---|
m:ur | p.u. | Voltage, Real Part |
m:ui | p.u. | Voltage, Imaginary Part |
m:u | p.u. | Voltage, Magnitude |
m:upc | % | Voltage, Magnitude |
m:du | % | Voltage Deviation |
m:U | kV | Line-Ground Voltage, Magnitude |
m:phiu | deg | Voltage, Angle |
m:phiurel | deg | Voltage, Relative Angle |
m:Ul | kV | Line-Line Voltage, Magnitude |
m:u1 | p.u. | Voltage, Magnitude |
m:u1pc | % | Voltage, Magnitude |
m:u1r | p.u. | Positive-Sequence Voltage, Real Part |
m:u1i | p.u. | Positive-Sequence Voltage, Imaginary Part |
m:Pgen | MW | Generation, Active Power |
m:Qgen | Mvar | Generation, Reactive Power |
m:Pmot | MW | Motor Load, Active Power |
m:Qmot | Mvar | Motor Load, Reactive Power |
m:Pload | MW | General Load, Active Power |
m:Qload | Mvar | General Load, Reactive Power |
m:Pcomp | MW | Compensation (Losses) |
m:Qcomp | Mvar | Compensation |
m:Pnet | MW | External Networks, Active Power |
m:Qnet | Mvar | External Networks, Reactive Power |
m:Pflow | MW | Power Flow, Active Power |
m:Qflow | Mvar | Power Flow, Reactive Power |
m:Pout | MW | Outgoing Flow, Active Power |
m:Qout | Mvar | Outgoing Power, Reactive Power |
m:Sout | MVA | Outgoing Power, Apparent Power |
m:cosphiout | ยท | Outgoing Power, Power Factor |
m:Pbalance | MW | Active Power Balance (=0) |
m:Qbalance | Mvar | Reactive Power Balance (=0) |
m:LossPdown | MW | Losses, downstream |
m:LossQdown | Mvar | Losses, downstream (Reactive Power) |
m:LossPdownload | MW | Load losses, downstream |
m:LossQdownload | Mvar | Load losses, downstream |
m:LossPdownnoload | MW | No load losses, downstream |
m:LossQdownnoload | Mvar | No load losses, downstream |
m:du_feed | % | Difference from voltage at start of feeder |
m:Inom | kA | Nominal Current |
m:Imax | kA | Max. Current |
m:loading | % | Loading |
m:idxImax | ยท | Index of section with max. current |
ElmTerm basic data
b: values are worked out from the input data. Read them; they are not set.
| Attribute | Unit | Description |
|---|---|---|
b:loc_name | ยท | Name |
b:nphase | ยท | number of phases |
b:index | ยท | index |
b:ur | p.u. | Bus Voltages (Real) |
b:ui | p.u. | Bus Voltages (Imaginary) |
b:ursym | p.u. | Bus Voltages (Real) |
b:uisym | p.u. | Bus Voltages (Imaginary) |
b:unom | kV | Nominal voltage |
b:imode | ยท | Flag indicating isolated Busbars |
b:ipat | ยท | Index of Isolated Area |
b:uini | p.u. | Initial Magnitude of Bus Voltage |
b:phiini | rad | Initial Angle of Bus Voltage |
b:isetw | ยท | Different Usage |
b:iseta | ยท | Different Usage |
b:Zc1 | p.u. | Short-Circuit Impedance 1 |
b:Zc2 | p.u. | Short-Circuit Impedance 2 |
b:Zc3 | p.u. | Short-Circuit Impedance 3 |
b:Zc4 | p.u. | Short-Circuit Impedance 4 |
b:dZc | p.u. | dZc/df |
b:Ic | p.u. | Short-Circuit Current |
b:Ic_rot | p.u. | Rotating Short-Circuit Current |
b:Ikss | p.u. | Subtransient Short-Circuit Current |
b:Ikss_rot | p.u. | Rotating Subtransient Short-Circuit Current |
b:Ikss_rot_break | p.u. | Rotating Subtransient Short-Circuit Current (without DFIG) |
b:Zc_rst | p.u. | Short-Circuit Impedance Matrix (RST) |
b:Zkss_rst | p.u. | Subtransient Short-Circuit Impedance Matrix (RST) |
b:dZc_rst | p.u. | dZc_rst/df |
b:Ic_rst | p.u. | Short-Circuit Current Vector (RST) |
b:Ic_rot_rst | p.u. | Rotating Short-Circuit Current Vector (RST) |
b:Ikss_rst | p.u. | Subtransient Short-Circuit Current-Vector (RST) |
b:Ikss_rot_rst | p.u. | Rotating Subtransient Short-Circuit Current Vector (RST) |
b:Ikss_rot_break_rst | p.u. | Rotating Subtransient Short-Circuit Current Vector (RST, without DFIG) |
b:isl | ยท | Slack-Flag |
b:imode1 | ยท | Mode of Phase 1 (A,B,C) |
b:imode2 | ยท | Mode of Phase 2 (A,B,C) |
b:imode3 | ยท | Mode of Phase 3 (A,B,C) |
b:systp | ยท | System type (0 |
b:iblock | ยท | Index of Power Station Unit |
b:Ithlim | kA | Rated Short-Time Current |
b:Tb | s | Break Time |
b:Tkr | s | Rated Short-Circuit Duration |
b:Iplim | kA | Max. Short-Circuit Peak Current |
b:dist | km | Distance from infeed |
b:iRelFlg | ยท | Reliability supply flag |
b:isminus | ยท | DC-Polarity |
b:iEarth | ยท | Earthed |
b:vmax | p.u. | Upper Voltage Limit |
b:vmin | p.u. | Lower Voltage Limit |
b:dist1 | km | Distance from infeed |
b:igarea | ยท | Galvanic separated Area Index |
b:phaseInd | ยท | Phase Index |
b:iPobsStat | ยท | Flag indicating whether P is observable |
b:iQobsStat | ยท | Flag indicating whether Q is observable |
b:iScaleobsStat | ยท | Flag indicating whether scaling factor is observable |
b:vstep_n1 | p.u. | Voltage Step Change Limit(n-1) |
b:vstep_nk | p.u. | Voltage Step Change Limit(n-2) |
b:vstep_bus | p.u. | Voltage Step Change Limit(bus fault) |
b:vstep_change | ยท | Voltage Step Change Limits |
b:uGradient | p.u./MW | Gradient of the voltage (only used for PV Curves) |
b:tpAreaIdx | ยท | Index of topological area |
b:tpAreaNiso | ยท | Topological area; no. of isolated Areas |
b:tpAreaFicBorderCon | ยท | Topological area; Connection to fictitious border grid |
b:maxVdrop | % | Maximum allowed Voltage Drop |
b:maxVrise | % | Maximum allowed Voltage Rise |
Related
- All 73 classes in the attribute reference
- Run a load flow and export the results with Python
- N-1 contingency analysis in Python
- Short-circuit automation in Python
- RMS and EMT simulation batch runs in Python
- Hosting capacity study
- PowerFactory Python API: getting started
โ ElmNec NEC/NER ยท ElmAsm Asynchronous Machine โ