ElmStactrl attributesPowerFactory Station Control
Every attribute of the PowerFactory Station Control (ElmStactrl): 84 input parameters and 31 result variables, with units and meaning. Copy a name into GetAttribute or SetAttribute.
What ElmStactrl is
A station controller: it shares the reactive power or voltage control of a station between several machines.
- Class
ElmStactrl, element class- PowerFactory name
- Station Control
- Attributes
- 84 input parameters and 31 result variables, in 2 calculations
Read and write ElmStactrl in Python
import powerfactory
app = powerfactory.GetApplication() # GetApplicationExt() from outside PowerFactory
for obj in app.GetCalcRelevantObjects("*.ElmStactrl"):
print(obj.loc_name, obj.GetAttribute("loc_name")) # Name
obj = app.GetCalcRelevantObjects("*.ElmStactrl")[0]
obj.SetAttribute("outserv", 1) # switch the controller off- An input parameter is read and written with or without its
e:prefix:GetAttribute("outserv")andGetAttribute("e:outserv")give the same value.
ElmStactrl 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 |
manuf | · | Manufacturer |
commissionDate | · | Commissioning Date |
appr_modby | · | Modified by |
outserv | · | Out of Service |
i_phase | · | Phase |
imode | · | Reactive Power Distribution |
consQdisp | · | Consider reactive power dispatch |
i_ctrl | · | Control Mode |
uset_mode | · | Setpoint |
iTrfCtrl | · | Step-up Transformer Control |
selBus | · | Controlled Node |
iQorient | · | Q change response |
pf_recap | · | Power Factor |
i_droop | · | Enable droop |
iopt_tdr | · | Use separate droop values for over-/underexcited operation |
qu_char | · | Q-Control |
cosphi_char | · | PF-Control |
constr | · | Year of Construction |
appr_status | · | Status |
usetp | p.u. | Voltage Setpoint |
selAutoUn | kV | Busbar Search Criteria >= |
qsetp | Mvar | Q Setpoint |
tansetp | · | tan(phi) |
pfsetp | · | Power Factor |
Tctrl | s | Controller Time Constant |
Kqshnt | % | Reactive power percentage |
TctrlShnt | s | Controller Time Constant |
Qdroop | Mvar/p.u. | Droop |
Srated | Mvar | Rated reactive power |
Qdroopue | Mvar/p.u. | Droop (underexcited) |
Qmin | Mvar | Qmin |
Qmax | Mvar | Qmax |
udeadbup | p.u. | Upper limit |
udeadblow | p.u. | Lower limit |
pf_under | · | Min. power factor |
pf_over | · | Min. power factor |
p_under | MW | Active power |
p_over | MW | Active power |
u_under | p.u. | Voltage |
u_over | p.u. | Voltage |
appr_modif | · | Modified |
desc | · | Description |
sOpComment | · | Operator Comment |
fold_id | · | In Folder |
rembar | · | Controlled NodeObject: StaBar*,ElmTerm* |
p_cub | · | Control Q atObject: StaCubic,ElmBoundary |
pQmeas | · | Q measured atObject: StaCubic,ElmBoundary |
pQPcurve | · | Q(P)-CurveObject: IntQpcurve |
pQVcurve | · | Q(V)-CurveObject: IntQvcurve |
doc_id | · | Additional Data |
pOwner | · | OwnerObject: ElmOwner |
pOperator | · | OperatorObject: ElmOperator |
psym | · | MachinesObject: ElmSym,ElmGenstat,ElmPvsys,ElmSvs,ElmStatcom,ElmAsm,ElmVsc*,ElmXnet |
pshunts | · | Shunt/FilterObject: ElmShnt |
cpHeadFold | · | Head Folder |
cpGrid | · | GridObject: ElmNet |
cpOwner | · | OwnerObject: ElmOwner |
cpOperator | · | OperatorObject: ElmOperator |
cpBranch | · | BranchObject: ElmBranch |
cpSite | · | SiteObject: ElmSite |
cpSubstat | · | SubstationObject: ElmSubstat,ElmTrfstat |
cDisplayName | · | Display Name |
u0qvref | p.u. | Reference voltage |
cconn | · | Connected |
cvqq | % | Reactive Power Percentage |
cvgen | p.u. | Voltage Setpoint |
cvgenmin | p.u. | Min. Voltage |
cvgenmax | p.u. | Max. Voltage |
cshntconn | · | Connected |
cshntswitchable | · | Switchable |
cpCtrlNode | · | Target NodeObject: ElmTerm |
ddroop | % | Droop |
deltaV | p.u. | delta(V) |
Qdroopoe | Mvar/p.u. | Droop (overexcited) |
ddroopoe | % | Droop (overexcited) |
ddroopue | % | Droop (underexcited) |
deltaVoe | p.u. | delta(V) (overexcited) |
deltaVue | p.u. | delta(V) (underexcited) |
refbar | · | Reference NodeObject: StaBar*,ElmTerm* |
ElmStactrl load flow results
Read after ComLdf with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:rembar | · | Controlled Busbar |
c:uini | p.u. | Voltage Setpoint |
c:qset | · | Reactive Power Percentage |
c:qres | Mvar | Reactive Power Reserve |
c:imode | · | Control Mode |
c:i_ctrl | · | Load Flow Control |
c:qini | Mvar | Reactive Power Setpoint |
c:Qdmeas | Mvar | Q(measured) for Droop |
c:Qdroop | Mvar/p.u. | Droop |
c:Qmin | Mvar | Lower limit of reactive power |
c:Qmax | Mvar | Upper limit of reactive power |
c:i_qlim | · | Reactive power limit reached |
c:nCtrlIter | · | No. of CTRL-iterations |
c:Tctrl | s | Controller Time Constant |
c:i_fixedtap | · | Flag |
c:i_phase | · | Controlled Phase |
ElmStactrl optimal power flow results
Read after ComOpf with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:rembar | · | Controlled Busbar |
c:uini | p.u. | Voltage Setpoint |
c:qset | · | Reactive Power Percentage |
c:qres | Mvar | Reactive Power Reserve |
c:imode | · | Control Mode |
c:i_ctrl | · | Load Flow Control |
c:qini | Mvar | Reactive Power Setpoint |
c:Qdmeas | Mvar | Q(measured) for Droop |
c:Qdroop | Mvar/p.u. | Droop |
c:Qmin | Mvar | Lower limit of reactive power |
c:Qmax | Mvar | Upper limit of reactive power |
c:i_qlim | · | Reactive power limit reached |
c:nCtrlIter | · | No. of CTRL-iterations |
c:Tctrl | s | Controller Time Constant |
c:i_fixedtap | · | Flag |
ElmStactrl 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_q | · | Number of Reactive Power Outputs |
b:n_sym | · | Number of Machines |
b:i_ctrl | · | Load Flow Control |
Related
- All 73 classes in the attribute reference
- Run a load flow and export the results with Python
- PowerFactory Python API: getting started
← ElmSecctrl Power-Frequency Controller · StaPll PLL Phase/Frequency Measurement →