ElmArea attributesPowerFactory Area

Every attribute of the PowerFactory Area (ElmArea): 14 input parameters and 314 result variables, with units and meaning. Copy a name into GetAttribute or SetAttribute.

What ElmArea is

An area: a group of elements for summary results (generation, load, losses, interchange) and area-wide actions.

Class: ElmArea, element class
PowerFactory name: Area
Attributes: 14 input parameters and 314 result variables, in 6 calculations

Read and write ElmArea in Python

import powerfactory

app = powerfactory.GetApplication()          # GetApplicationExt() from outside PowerFactory

for obj in app.GetCalcRelevantObjects("*.ElmArea"):
    print(obj.loc_name, obj.GetAttribute("loc_name")) # Name

obj = app.GetCalcRelevantObjects("*.ElmArea")[0]
obj.SetAttribute("loc_name", "Area North")    # rename the area

An input parameter is read and written with or without its e: prefix: GetAttribute("outserv") and GetAttribute("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. GetAttribute after a run gives the value at the last time step.

Input parameters14
Load flow results102
RMS simulation results25
EMT simulation results25
DC load flow results37
Modal analysis results25
Optimal power flow results100
Basic data3

ElmArea 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
`icolor`	·	Colour
`iInterChg`	·	Consider Interchange Schedule
`isConsSpinReserve`	·	Min. spinning reserve constraint
`InterPset`	MW	Scheduled Active Power Interchange
`spinReserve`	MW	Spinning reserve
`appr_modif`	·	Modified
`desc`	·	Description
`cimRdfId`	·	RDF ID

ElmArea load flow results

Read after ComLdf with GetAttribute. c: calculation parameter.

Attribute	Unit	Description
`c:n_ele`	·	Number of Elements
`c:n_areas`	·	Number of Connected Areas
`c:n_volt`	·	Number of Voltage Levels
`c:n_bar`	·	No. of Busbars
`c:n_term`	·	No. of Terminals
`c:n_lne`	·	No. of Lines
`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_cust`	·	No. of Customers
`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: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:RUC_Lead`	Mvar	Used Reactive Capacity Lead
`c:RUC_Lag`	Mvar	Used Reactive Capacity Lag
`c:RSC_Lead`	Mvar	Spare Reactive Capacity Lead
`c:RSC_Lag`	Mvar	Spare Reactive Capacity Lag
`c:Q_shgain`	Mvar	Reactive Power Shunt Gain
`c:ConnMvar_max`	Mvar	Connected MVAR Capacity (max)
`c:ConnMvar_min`	Mvar	Connected MVAR Capacity (min)
`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

ElmArea 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:Pt`	MW	Turbine Power
`c:Pres`	MW	Available-Reserve

ElmArea 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:Pt`	MW	Turbine Power
`c:Pres`	MW	Available Reserve

ElmArea dc load flow results

Read after ComLdf (DC) with GetAttribute. c: calculation parameter.

Attribute	Unit	Description
`c:n_ele`	·	Number of Elements
`c:n_areas`	·	Number of Connected Areas
`c:n_volt`	·	Number of Voltage Levels
`c:n_bar`	·	No. of Busbars
`c:n_term`	·	No. of Terminals
`c:n_lne`	·	No. of Lines
`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_cust`	·	Number of Customers
`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: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

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:Pt`	MW	Turbine Power
`c:Pres`	MW	Available-Reserve

ElmArea optimal power flow results

Read after ComOpf with GetAttribute. c: calculation parameter.

Attribute	Unit	Description
`c:n_ele`	·	Number of Elements
`c:n_areas`	·	Number of Connected Areas
`c:n_volt`	·	Number of Voltage Levels
`c:n_bar`	·	No. of Busbars
`c:n_term`	·	No. of Terminals
`c:n_lne`	·	No. of Lines
`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_cust`	·	No. of Customers
`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: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:RUC_Lead`	Mvar	Used Reactive Capacity Lead
`c:RUC_Lag`	Mvar	Used Reactive Capacity Lag
`c:RSC_Lead`	Mvar	Spare Reactive Capacity Lead
`c:RSC_Lag`	Mvar	Spare Reactive Capacity Lag
`c:Q_shgain`	Mvar	Reactive Power Shunt Gain
`c:ConnMvar_max`	Mvar	Connected MVAR Capacity (max)
`c:ConnMvar_min`	Mvar	Connected MVAR Capacity (min)
`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

ElmArea 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_areas`	·	Number of Areas

← StaPll PLL Phase/Frequency Measurement · ElmBbone Backbone →