ElmSecctrl attributesPowerFactory Power-Frequency Controller
Every attribute of the PowerFactory Power-Frequency Controller (ElmSecctrl): 39 input parameters and 27 result variables, with units and meaning. Copy a name into GetAttribute or SetAttribute.
What ElmSecctrl is
A power-frequency controller: secondary (AGC) control that shares a power change between generators to bring frequency and interchange back.
- Class
ElmSecctrl, element class- PowerFactory name
- Power-Frequency Controller
- Attributes
- 39 input parameters and 27 result variables, in 3 calculations
Read and write ElmSecctrl in Python
import powerfactory
app = powerfactory.GetApplication() # GetApplicationExt() from outside PowerFactory
for obj in app.GetCalcRelevantObjects("*.ElmSecctrl"):
print(obj.loc_name, obj.GetAttribute("loc_name")) # Name
obj = app.GetCalcRelevantObjects("*.ElmSecctrl")[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.
ElmSecctrl 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_net | · | Control Mode |
iexchange | · | Exchange for |
imode | · | Active Power Distribution |
constr | · | Year of Construction |
appr_status | · | Status |
psetp | MW | Power Setpoint |
dReserve | MW | Minimum Control Reserve |
Pexmax | MW | Maximum Power Interchange |
Kpf | MW/Hz | Frequency Bias |
appr_modif | · | Modified |
cimRdfId | · | RDF ID |
desc | · | Description |
fold_id | · | In Folder |
rembar | · | Busbar for Frequency MeasurementObject: StaBar*,ElmTerm* |
pPmeas | · | Boundary/Zone/AreaObject: ElmBoundary,ElmArea,ElmZone |
doc_id | · | Additional Data |
pOwner | · | OwnerObject: ElmOwner |
pOperator | · | OperatorObject: ElmOperator |
psym | · | MachinesObject: ElmSym,ElmGenstat,ElmVscmono,ElmVsc,ElmVac,ElmXnet,ElmPvsys |
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 |
cvpp | % | Active Power Percentage |
cmo | · | Merit Order |
qdslCtrl | · | Quasi-Dynamic ModelObject: ElmQdsl |
ElmSecctrl load flow results
Read after ComLdf with GetAttribute. c: calculation parameter, s: signal (state or model variable).
| Attribute | Unit | Description |
|---|---|---|
c:rembar | · | Controlled Busbar |
c:pini | MW | Active Power Setpoint |
c:imode | · | Control Mode |
c:i_modus | · | Control Mode 0=phi 1=p |
c:phiu | rad | Phase Angle |
c:PExch | MW | Power Exchange |
c:PctrlLim | MW | Controller Output Limit |
c:nCtrlIter | · | No. of CTRL-iterations |
c:i_phase | · | Controlled Phase |
s:pset | MW | Active Power Setpoint |
s:dpsco | MW | Controller Output |
ElmSecctrl dc load flow results
Read after ComLdf (DC) with GetAttribute. c: calculation parameter, s: signal (state or model variable).
| Attribute | Unit | Description |
|---|---|---|
c:rembar | · | Controlled Busbar |
c:pini | MW | Active Power Setpoint |
c:imode | · | Control Mode |
c:i_modus | · | Control Mode 0=phi 1=p |
c:phiu | rad | Phase Angle |
c:PExch | MW | Power Exchange |
c:PctrlLim | MW | Controller Output Limit |
s:dpsco | MW | Controller Output |
ElmSecctrl optimal power flow results
Read after ComOpf with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:rembar | · | Controlled Busbar |
c:pini | MW | Active Power Setpoint |
c:imode | · | Control Mode |
c:i_modus | · | Control Mode 0=phi 1=p |
c:phiu | rad | Phase Angle |
c:PExch | MW | Power Exchange |
c:PctrlLim | MW | Controller Output Limit |
c:nCtrlIter | · | No. of CTRL-iterations |
ElmSecctrl 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_sym | · | Number of Machines |
b:i_modus | · | Control Mode 0=phi 1=p |
b:i_net | · | Control Area Exchange |