ElmRelay attributesPowerFactory Relay
Every attribute of the PowerFactory Relay (ElmRelay): 47 input parameters and 11 result variables, with units and meaning. Copy a name into GetAttribute or SetAttribute.
What ElmRelay is
A relay: a protection device built from measurement, timer and logic blocks, which trips breakers in a simulation or a protection study.
- Class
ElmRelay, element class- PowerFactory name
- Relay
- Attributes
- 47 input parameters and 11 result variables, in 5 calculations
Read and write ElmRelay in Python
import powerfactory
app = powerfactory.GetApplication() # GetApplicationExt() from outside PowerFactory
for obj in app.GetCalcRelevantObjects("*.ElmRelay"):
print(obj.loc_name, obj.GetAttribute("loc_name")) # Name
obj = app.GetCalcRelevantObjects("*.ElmRelay")[0]
obj.SetAttribute("outserv", 1) # switch the relay off- 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 parameters47
- Load flow results2
- Short-circuit results2
- RMS simulation results2
- EMT simulation results3
- Modal analysis results2
- Basic data3
ElmRelay 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 |
outserv | · | Out of Service |
constr | · | Year of Construction |
appr_status | · | Status |
dev_no | · | Device Number |
application | · | Application |
phfaultmini | kA | Min. phase fault current |
phfaultmaxi | kA | Max. phase fault current |
efaultmini | kA | Min. earth fault current |
efaultmaxi | kA | Max. earth fault current |
appr_modif | · | Modified |
desc | · | Description |
fold_id | · | In Folder |
typ_id | · | Relay TypeObject: TypRelay |
doc_id | · | Additional Data |
pOwner | · | OwnerObject: ElmOwner |
pOperator | · | OperatorObject: ElmOperator |
pReference | · | ReferenceObject: ElmTerm,StaCubic |
contents | · | Contents |
cpHeadFold | · | Head Folder |
cpGrid | · | GridObject: ElmNet |
cpSite | · | SiteObject: ElmSite |
cpSubstat | · | SubstationObject: ElmSubstat,ElmTrfstat |
cDisplayName | · | Display Name |
pdiselm | · | Net ElementsObject: Rel*,Elm*,Sta*,IntRef |
cn_bus | · | BusbarObject: ElmTerm |
cbranch | · | BranchObject: Elm*,RelFuse,StaSua* |
cctprim | A | CT Primary |
cctsec | A | CT Secondary |
cvtprim | V | VT Primary |
cvtsec | V | VT Secondary |
cpCt | · | Current TransformerObject: StaCt*,StaCombi |
cpVt | · | Voltage TransformerObject: StaVt*,StaCombi |
ccategory | · | Main function |
ccat_curr | · | Overcurrent |
ccat_dist | · | Distance |
ccat_diff | · | Differential |
ccat_volt | · | Voltage |
ccat_freq | · | Frequency |
ccat_dir | · | Directional |
cpShc | · | Short-circuit command |
ElmRelay load flow results
Read after ComLdf with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:yout | s | Tripping Time |
c:Imax | kA | Maximum Current |
ElmRelay short-circuit results
Read after ComShc with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:yout | s | Tripping Time |
c:Imax | kA | Maximum Current |
ElmRelay rms simulation results
Read after ComInc (RMS) with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:yout | · | Tripping |
c:Ttrip | s | Tripping Time |
ElmRelay emt simulation results
Read after ComInc (EMT) with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:yout | · | Tripping |
c:Ttrip | s | Tripping Time |
c:fnom | Hz | Nominal Frequency |
ElmRelay modal analysis results
Read after ComMod with GetAttribute. c: calculation parameter.
| Attribute | Unit | Description |
|---|---|---|
c:yout | · | Tripping |
c:Ttrip | s | Tripping Time |
ElmRelay basic data
b: values are worked out from the input data. Read them; they are not set.
| Attribute | Unit | Description |
|---|---|---|
b:Inom | sec.A | Nominal Current |
b:Unom | sec.V | Nominal Voltage |
b:loc_name | · | Name |
Related
- All 73 classes in the attribute reference
- Run a load flow and export the results with Python
- PowerFactory Python API: getting started
← ElmMdl Modelica Model · ElmSecctrl Power-Frequency Controller →