ElmNet attributesPowerFactory Grid
Every attribute of the PowerFactory Grid (ElmNet): 19 input parameters and 346 result variables, with units and meaning. Copy a name into GetAttribute or SetAttribute.
What ElmNet is
A grid: the container that holds a network's elements. It carries the nominal frequency and grid summary results such as total generation, load and losses.
- Class
ElmNet, element class- PowerFactory name
- Grid
- Attributes
- 19 input parameters and 346 result variables, in 6 calculations
Most used ElmNet attributes
| Attribute | Unit | Description | Where |
|---|---|---|---|
frnom | Hz | Nominal Frequencynominal frequency | input data |
c:Pgen | MW | Generators, Active Powertotal generation | RMS simulation |
c:Pload | MW | Loads, Active Powertotal load | RMS simulation |
c:Ploss | MW | Losses, Active Powertotal losses | RMS simulation |
Read and write ElmNet in Python
import powerfactory
app = powerfactory.GetApplication() # GetApplicationExt() from outside PowerFactory
for grid in app.GetCalcRelevantObjects("*.ElmNet"):
print(grid.loc_name, grid.GetAttribute("frnom")) # Nominal Frequency
grid = app.GetCalcRelevantObjects("*.ElmNet")[0]
grid.SetAttribute("frnom", 50) # nominal frequency 50 Hz- 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 parameters19
- Load flow results109
- RMS simulation results26
- EMT simulation results26
- DC load flow results51
- Modal analysis results26
- Optimal power flow results108
- Basic data4
ElmNet 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 |
appr_modby | · | Modified by |
appr_status | · | Status |
fictborder | · | Fictitious border grid |
icolor | · | Colour |
iInterChg | · | Consider Interchange Schedule |
isConsSpinReserve | · | Min. spinning reserve constraint |
frnom | Hz | Nominal Frequency |
InterPset | MW | Scheduled Active Power Interchange |
spinReserve | MW | Spinning reserve |
appr_modif | · | Modified |
cimRdfId | · | RDF ID |
desc | · | Description |
owner | · | Owner |
pDiagram | · | DiagramObject: IntGrfnet |
contents | · | Contents |
ElmNet load flow results
Read after ComLdf with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:n_ele | · | Number of Elements |
c:n_area | · | Number of Connected Grids |
c:n_volt | · | Number of Voltage Levels |
c:n_sta | · | No. of Substations |
c:n_bar | · | No. of Busbars |
c:n_term | · | No. of Terminals |
c:n_lne | · | No. of Lines |
c:n_2wt | · | No. of 2-w Trfs. |
c:n_3wt | · | No. of 3-w Trfs. |
c:n_4wt | · | No. of 4-w Trfs. |
c:n_sym | · | No. of syn. Machines |
c:n_asm | · | No. of asyn. Machines |
c:n_stg | · | No. of Static Generators |
c:n_pvs | · | No. of PV Systems |
c:n_lod | · | No. of Loads |
c:n_svs | · | No. of SVS |
c:n_statcom | · | No. of STATCOM |
c:n_shnt | · | No. of Shunts/Filters |
c:n_other | · | No. of Other Elements |
c:n_iso | · | No. of Isolated Areas |
c:n_isooff | · | No. of Unsupplied Isolated Areas |
c:TotgenP | MW | Total Generation, Active Power |
c:TotgenQ | Mvar | Total Generation, Reactive Power |
c:TotconsP | MW | Total Consumption, Active Power |
c:TotconsQ | Mvar | Total Consumption, Reactive Power |
c:GenP | MW | Generators, Active Power |
c:GenQ | Mvar | Generators, Reactive Power |
c:GenS | MVA | Generators, Apparent Power |
c:Gencos | · | Generators, Power Factor |
c:GenPnom | MW | Generators, Nominal Active Power |
c:GenQnom | Mvar | Generators, Nominal Reactive Power |
c:GenSnom | MVA | Generators, Nominal Apparent Power |
c:GenPdiff | MW | Generators, difference between nominal and actual active power |
c:GenQdiff | Mvar | Generators, difference between nominal and actual reactive power |
c:Gencosnom | · | Generators, Nominal Power Factor |
c:GenPdisp | MW | Generators, Dispatch Active Power |
c:GenPmism | MW | Generators, difference between actual and dispatched active power |
c:GenPspinres | MW | Generators, difference between maximum and actual active power |
c:GenQspinres | Mvar | Generators, difference between maximum and actual reactive power |
c:MotP | MW | Motor Loads, Active Power |
c:MotQ | Mvar | Motor Loads, Reactive Power |
c:MotS | MVA | Motor Loads, Apparent Power |
c:Motcos | · | Motor Loads, Power Factor |
c:LoadP | MW | Loads, Active Power |
c:LoadQ | Mvar | Loads, Reactive Power |
c:LoadS | MVA | Loads, Apparent Power |
c:Loadcos | · | Loads, Power Factor |
c:LoadPnom | MW | Loads, Nominal Active Power |
c:LoadQnom | Mvar | Loads, Nominal Reactive Power |
c:LoadSnom | MVA | Loads, Nominal Apparent Power |
c:Loadcosnom | · | Loads, Nominal Power Factor |
c:LoadPdiff | MW | Loads, difference between nominal and actual active power |
c:LoadQdiff | Mvar | Loads, difference between nominal and actual reactive power |
c:LoadPdem | MW | Loads, Active Power Demand |
c:LoadPmism | MW | Loads, difference between actual active power and demand |
c:CompP | MW | Compensation (Losses) |
c:CompQ | Mvar | Compensation, C |
c:ComprQ | Mvar | Compensation, L |
c:NetP | MW | External Networks, Active Power |
c:NetQ | Mvar | External Networks, Reactive Power |
c:NetS | MVA | External Networks, Apparent Power |
c:Netcos | · | External Networks, Power Factor |
c:InterP | MW | Interchange Flow, Active Power |
c:InterQ | Mvar | Interchange Flow, Reactive Power |
c:LossP | MW | Losses, Active Power |
c:LossQ | Mvar | Losses, Reactive Power |
c:LossPld | MW | Losses, Active Power (load) |
c:LossQld | Mvar | Losses, Reactive Power (load) |
c:LossPnld | MW | Losses, Active Power (no load) |
c:LossQnld | Mvar | Losses, Reactive Power (no load) |
c:LossPlne | MW | Line Losses, Active Power |
c:LossQlne | Mvar | Line Losses, Reactive Power |
c:LossPldlne | MW | Line Losses, Active Power (load) |
c:LossQldlne | Mvar | Line Losses, Reactive Power (load) |
c:LossPnldlne | MW | Line Losses, Active Power (no load) |
c:LossQnldlne | Mvar | Line Losses, Reactive Power (no load) |
c:LossPtrf | MW | Transformer Losses, Active Power |
c:LossQtrf | Mvar | Transformer Losses, Reactive Power |
c:LossPldtrf | MW | Transformer Losses, Active Power (load) |
c:LossQldtrf | Mvar | Transformer Losses, Reactive Power (load) |
c:LossPnldtrf | MW | Transformer Losses, Active Power (no load) |
c:LossQnldtrf | Mvar | Transformer Losses, Reactive Power (no load) |
c:TotLoadP | MW | Total Load, Active Power |
c:TotLoadQ | Mvar | Total Load, Reactive Power |
c:TotLoadS | MVA | Total Load, Apparent Power |
c:TotLoadcos | · | Total Load, Power Factor |
c:TotP | MW | Total Demand |
c:UnsupP | MW | Unsupplied Demand |
c:SupP | MW | Supplied Demand |
c:isummary | · | Flag for Summary Grid |
c:n_cust | · | Number of Customers |
c:n_cunsup | · | Number of unsupplied Customers |
c:n_unsup | · | Number of unsupplied Loads |
c:ptot | MW | Total Area Exchange Power |
c:ExportP | MW | Export, Active Power |
c:ExportQ | Mvar | Export, Reactive Power |
c:ImportP | MW | Import, Active Power |
c:ImportQ | Mvar | Import, Reactive Power |
c:cst_disp | USD/h | Total Production Costs |
c:NrOvlBranch | · | Number of overloaded branch components |
c:NrTermMin | · | Number of terminals below their minimum voltage limit |
c:NrTermMax | · | Number of terminals above their maximum voltage limit |
c:Maxloading | % | Maximum Loading |
c:NrGenQMax | · | Number of generators above their maximum reactive power limit |
c:NrGenQMin | · | Number of generators below their minimum reactive power limit |
c:umin | p.u. | Minimum voltage of all terminals |
c:umax | p.u. | Maximum voltage of all terminals |
c:uphtmin | p.u. | Minimum voltage of all terminals |
c:uphtmax | p.u. | Maximum voltage of all terminals |
ElmNet rms simulation results
Read after ComInc (RMS) with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:Pgen | MW | Generators, Active Power |
c:Qgen | Mvar | Generators, Reactive Power |
c:Sgen | MVA | Generators, Apparent Power |
c:cosgen | · | Generators, Power Factor |
c:Pmot | MW | Motor Loads, Active Power |
c:Qmot | Mvar | Motor Loads, Reactive Power |
c:Smot | MVA | Motor Loads, Apparent Power |
c:cosmot | · | Motor Loads, Power Factor |
c:Pload | MW | Loads, Active Power |
c:Qload | Mvar | Loads, Reactive Power |
c:Sload | MVA | Loads, Apparent Power |
c:cosload | · | Loads, Power Factor |
c:Pcomp | MW | Compensation (Losses) |
c:Qcomp | Mvar | Compensation, C |
c:Qcompr | Mvar | Compensation, L |
c:Pnet | MW | External Networks, Active Power |
c:Qnet | Mvar | External Networks, Reactive Power |
c:Snet | MVA | External Networks, Apparent Power |
c:cosnet | · | External Networks, Power Factor |
c:Pinter | MW | Interchange Flow, Active Power |
c:Qinter | Mvar | Interchange Flow, Reactive Power |
c:Ploss | MW | Losses, Active Power |
c:Qloss | Mvar | Losses, Reactive Power |
c:isummary | · | Flag for Summary Grid |
c:Pt | MW | Turbine Power |
c:Pres | MW | Available-Reserve |
ElmNet emt simulation results
Read after ComInc (EMT) with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:Pgen | MW | Generators, Active Power |
c:Qgen | Mvar | Generators, Reactive Power |
c:Sgen | MVA | Generators, Apparent Power |
c:cosgen | · | Generators, Power Factor |
c:Pmot | MW | Motor Loads, Active Power |
c:Qmot | Mvar | Motor Loads, Reactive Power |
c:Smot | MVA | Motor Loads, Apparent Power |
c:cosmot | · | Motor Loads, Power Factor |
c:Pload | MW | Loads, Active Power |
c:Qload | Mvar | Loads, Reactive Power |
c:Sload | MVA | Loads, Apparent Power |
c:cosload | · | Loads, Power Factor |
c:Pcomp | MW | Compensation (Losses) |
c:Qcomp | Mvar | Compensation, C |
c:Qcompr | Mvar | Compensation, L |
c:Pnet | MW | External Networks, Active Power |
c:Qnet | Mvar | External Networks, Reactive Power |
c:Snet | MVA | External Networks, Apparent Power |
c:cosnet | · | External Networks, Power Factor |
c:Pinter | MW | Interchange Flow, Active Power |
c:Qinter | Mvar | Interchange Flow, Reactive Power |
c:Ploss | MW | Losses, Active Power |
c:Qloss | Mvar | Losses, Reactive Power |
c:isummary | · | Flag for Summary Grid |
c:Pt | MW | Turbine Power |
c:Pres | MW | Available Reserve |
ElmNet dc load flow results
Read after ComLdf (DC) with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:n_ele | · | Number of Elements |
c:n_area | · | Number of Connected Grids |
c:n_volt | · | Number of Voltage Levels |
c:n_sta | · | No. of Substations |
c:n_bar | · | No. of Busbars |
c:n_term | · | No. of Terminals |
c:n_lne | · | No. of Lines |
c:n_2wt | · | No. of 2-w Trfs. |
c:n_3wt | · | No. of 3-w Trfs. |
c:n_4wt | · | No. of 4-w Trfs. |
c:n_sym | · | No. of syn. Machines |
c:n_asm | · | No. of asyn. Machines |
c:n_stg | · | No. of Static Generators |
c:n_pvs | · | No. of PV Systems |
c:n_lod | · | No. of Loads |
c:n_svs | · | No. of SVS |
c:n_statcom | · | No. of STATCOM |
c:n_shnt | · | No. of Shunts/Filters |
c:n_other | · | No. of Other Elements |
c:n_iso | · | No. of Isolated Areas |
c:n_isooff | · | No. of Unsupplied Isolated Areas |
c:TotgenP | MW | Total Generation, Active Power |
c:TotconsP | MW | Total Consumption, Active Power |
c:GenP | MW | Generators, Active Power |
c:GenPnom | MW | Generators, Nominal Active Power |
c:GenPdiff | MW | Generators, difference between nominal and actual active power |
c:GenPdisp | MW | Generators, Dispatch Active Power |
c:GenPmism | MW | Generators, difference between actual and dispatched active power |
c:GenPspinres | MW | Generators, difference between maximum and actual active power |
c:MotP | MW | Motor Loads, Active Power |
c:LoadP | MW | Loads, Active Power |
c:LoadPnom | MW | Loads, Nominal Active Power |
c:LoadPdiff | MW | Loads, difference between nominal and actual active power |
c:LoadPdem | MW | Loads, Active Power Demand |
c:LoadPmism | MW | Loads, difference between actual active power and demand |
c:NetP | MW | External Networks, Active Power |
c:InterP | MW | Interchange Flow, Active Power |
c:TotLoadP | MW | Total Load, Active Power |
c:TotP | MW | Total Demand |
c:UnsupP | MW | Unsupplied Demand |
c:SupP | MW | Supplied Demand |
c:isummary | · | Flag for Summary Grid |
c:n_cust | · | Number of Customers |
c:n_cunsup | · | Number of unsupplied Customers |
c:n_unsup | · | Number of unsupplied Loads |
c:ptot | MW | Total Area Exchange Power |
c:ExportP | MW | Export, Active Power |
c:ImportP | MW | Import, Active Power |
c:cst_disp | USD/h | Total Production Costs |
c:NrOvlBranch | · | Number of overloaded branch components |
c:Maxloading | % | Maximum Loading |
ElmNet modal analysis results
Read after ComMod with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:Pgen | MW | Generators, Active Power |
c:Qgen | Mvar | Generators, Reactive Power |
c:Sgen | MVA | Generators, Apparent Power |
c:cosgen | · | Generators, Power Factor |
c:Pmot | MW | Motor Loads, Active Power |
c:Qmot | Mvar | Motor Loads, Reactive Power |
c:Smot | MVA | Motor Loads, Apparent Power |
c:cosmot | · | Motor Loads, Power Factor |
c:Pload | MW | Loads, Active Power |
c:Qload | Mvar | Loads, Reactive Power |
c:Sload | MVA | Loads, Apparent Power |
c:cosload | · | Loads, Power Factor |
c:Pcomp | MW | Compensation (Losses) |
c:Qcomp | Mvar | Compensation, C |
c:Qcompr | Mvar | Compensation, L |
c:Pnet | MW | External Networks, Active Power |
c:Qnet | Mvar | External Networks, Reactive Power |
c:Snet | MVA | External Networks, Apparent Power |
c:cosnet | · | External Networks, Power Factor |
c:Pinter | MW | Interchange Flow, Active Power |
c:Qinter | Mvar | Interchange Flow, Reactive Power |
c:Ploss | MW | Losses, Active Power |
c:Qloss | Mvar | Losses, Reactive Power |
c:isummary | · | Flag for Summary Grid |
c:Pt | MW | Turbine Power |
c:Pres | MW | Available-Reserve |
ElmNet optimal power flow results
Read after ComOpf with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:n_ele | · | Number of Elements |
c:n_area | · | Number of Connected Grids |
c:n_volt | · | Number of Voltage Levels |
c:n_sta | · | No. of Substations |
c:n_bar | · | No. of Busbars |
c:n_term | · | No. of Terminals |
c:n_lne | · | No. of Lines |
c:n_2wt | · | No. of 2-w Trfs. |
c:n_3wt | · | No. of 3-w Trfs. |
c:n_4wt | · | No. of 4-w Trfs. |
c:n_sym | · | No. of syn. Machines |
c:n_asm | · | No. of asyn. Machines |
c:n_stg | · | No. of Static Generators |
c:n_pvs | · | No. of PV Systems |
c:n_lod | · | No. of Loads |
c:n_svs | · | No. of SVS |
c:n_statcom | · | No. of STATCOM |
c:n_shnt | · | No. of Shunts/Filters |
c:n_other | · | No. of Other Elements |
c:n_iso | · | No. of Isolated Areas |
c:n_isooff | · | No. of Unsupplied Isolated Areas |
c:TotgenP | MW | Total Generation, Active Power |
c:TotgenQ | Mvar | Total Generation, Reactive Power |
c:TotconsP | MW | Total Consumption, Active Power |
c:TotconsQ | Mvar | Total Consumption, Reactive Power |
c:GenP | MW | Generators, Active Power |
c:GenQ | Mvar | Generators, Reactive Power |
c:GenS | MVA | Generators, Apparent Power |
c:Gencos | · | Generators, Power Factor |
c:GenPnom | MW | Generators, Nominal Active Power |
c:GenQnom | Mvar | Generators, Nominal Reactive Power |
c:GenSnom | MVA | Generators, Nominal Apparent Power |
c:GenPdiff | MW | Generators, difference between nominal and actual active power |
c:GenQdiff | Mvar | Generators, difference between nominal and actual reactive power |
c:Gencosnom | · | Generators, Nominal Power Factor |
c:GenPdisp | MW | Generators, Dispatch Active Power |
c:GenPmism | MW | Generators, difference between actual and dispatched active power |
c:GenPspinres | MW | Generators, difference between maximum and actual active power |
c:GenQspinres | Mvar | Generators, difference between maximum and actual reactive power |
c:MotP | MW | Motor Loads, Active Power |
c:MotQ | Mvar | Motor Loads, Reactive Power |
c:MotS | MVA | Motor Loads, Apparent Power |
c:Motcos | · | Motor Loads, Power Factor |
c:LoadP | MW | Loads, Active Power |
c:LoadQ | Mvar | Loads, Reactive Power |
c:LoadS | MVA | Loads, Apparent Power |
c:Loadcos | · | Loads, Power Factor |
c:LoadPnom | MW | Loads, Nominal Active Power |
c:LoadQnom | Mvar | Loads, Nominal Reactive Power |
c:LoadSnom | MVA | Loads, Nominal Apparent Power |
c:Loadcosnom | · | Loads, Nominal Power Factor |
c:LoadPdiff | MW | Loads, difference between nominal and actual active power |
c:LoadQdiff | Mvar | Loads, difference between nominal and actual reactive power |
c:LoadPdem | MW | Loads, Active Power Demand |
c:LoadPmism | MW | Loads, difference between actual active power and demand |
c:CompP | MW | Compensation (Losses) |
c:CompQ | Mvar | Compensation, C |
c:ComprQ | Mvar | Compensation, L |
c:NetP | MW | External Networks, Active Power |
c:NetQ | Mvar | External Networks, Reactive Power |
c:NetS | MVA | External Networks, Apparent Power |
c:Netcos | · | External Networks, Power Factor |
c:InterP | MW | Interchange Flow, Active Power |
c:InterQ | Mvar | Interchange Flow, Reactive Power |
c:LossP | MW | Losses, Active Power |
c:LossQ | Mvar | Losses, Reactive Power |
c:LossPld | MW | Losses, Active Power (load) |
c:LossQld | Mvar | Losses, Reactive Power (load) |
c:LossPnld | MW | Losses, Active Power (no load) |
c:LossQnld | Mvar | Losses, Reactive Power (no load) |
c:LossPlne | MW | Line Losses, Active Power |
c:LossQlne | Mvar | Line Losses, Reactive Power |
c:LossPldlne | MW | Line Losses, Active Power (load) |
c:LossQldlne | Mvar | Line Losses, Reactive Power (load) |
c:LossPnldlne | MW | Line Losses, Active Power (no load) |
c:LossQnldlne | Mvar | Line Losses, Reactive Power (no load) |
c:LossPtrf | MW | Transformer Losses, Active Power |
c:LossQtrf | Mvar | Transformer Losses, Reactive Power |
c:LossPldtrf | MW | Transformer Losses, Active Power (load) |
c:LossQldtrf | Mvar | Transformer Losses, Reactive Power (load) |
c:LossPnldtrf | MW | Transformer Losses, Active Power (no load) |
c:LossQnldtrf | Mvar | Transformer Losses, Reactive Power (no load) |
c:TotLoadP | MW | Total Load, Active Power |
c:TotLoadQ | Mvar | Total Load, Reactive Power |
c:TotLoadS | MVA | Total Load, Apparent Power |
c:TotLoadcos | · | Total Load, Power Factor |
c:TotP | MW | Total Demand |
c:UnsupP | MW | Unsupplied Demand |
c:SupP | MW | Supplied Demand |
c:isummary | · | Flag for Summary Grid |
c:n_cust | · | Number of Customers |
c:n_cunsup | · | Number of unsupplied Customers |
c:n_unsup | · | Number of unsupplied Loads |
c:ptot | MW | Total Area Exchange Power |
c:ExportP | MW | Export, Active Power |
c:ExportQ | Mvar | Export, Reactive Power |
c:ImportP | MW | Import, Active Power |
c:ImportQ | Mvar | Import, Reactive Power |
c:cst_disp | USD/h | Total Production Costs |
c:NrOvlBranch | · | Number of overloaded branch components |
c:NrTermMin | · | Number of terminals below their minimum voltage limit |
c:NrTermMax | · | Number of terminals above their maximum voltage limit |
c:Maxloading | % | Maximum Loading |
c:NrGenQMax | · | Number of generators above their maximum reactive power limit |
c:NrGenQMin | · | Number of generators below their minimum reactive power limit |
c:umin | p.u. | Minimum voltage of all terminals |
c:umax | p.u. | Maximum voltage of all terminals |
c:QtargetDelta | Mvar | Total deviation from Q target values |
ElmNet 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:n_ele | · | Number of Elements |
b:n_area | · | Number of Connected Grids |
b:frnom | · | Nominal Frequency |