ElmDsl attributesPowerFactory DSL Model

Every attribute of the PowerFactory DSL Model (ElmDsl): 19 input parameters and 6 result variables, with units and meaning. Copy a name into GetAttribute or SetAttribute.

What ElmDsl is

A DSL model: one instance of a dynamic model definition (BlkDef), such as a governor, an exciter or a plant controller, used in RMS and EMT simulations. Its parameters are a list in params, in the order of the definition.

Class
ElmDsl, element class
PowerFactory name
DSL Model
Attributes
19 input parameters and 6 result variables, in 3 calculations

Read and write ElmDsl in Python

import powerfactory

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

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

obj = app.GetCalcRelevantObjects("*.ElmDsl")[0]
obj.SetAttribute("outserv", 1)                # switch the model off
  • 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.

ElmDsl input parameters

The element data, as typed in GetAttribute and SetAttribute (the e: prefix is optional). Setting one changes the model.

AttributeUnitDescription
loc_name·Name
chr_name·Characteristic Name
for_name·Foreign Key
dat_src·Data source
appr_modby·Modified by
outserv·Out of Service
appr_status·Status
iAstabint·A-stable integration algorithm (only for RMS Simulation)
appr_modif·Modified
params·Parameter
matrix·Characteristics
matrix2·Two Dimensional Characteristics
desc·Description
signal·Signal Name
typ_id·TypeObject: BlkDef*
pelm·Net ElementObject: Elm*,Sta*,IntRef
parameterNames·Parameter Names
oarrmat·Array/MatrixObject: IntMat
configScript·Configuration Script

ElmDsl rms simulation results

Read after ComInc (RMS) with GetAttribute. c: calculation parameter.

AttributeUnitDescription
c:isMatlab·MATLAB
c:fMatlab·M-file

ElmDsl emt simulation results

Read after ComInc (EMT) with GetAttribute. c: calculation parameter.

AttributeUnitDescription
c:isMatlab·MATLAB
c:fMatlab·M-file

Read after ComMod with GetAttribute. c: calculation parameter.

AttributeUnitDescription
c:isMatlab·MATLAB
c:fMatlab·M-file

ElmDsl basic data

b: values are worked out from the input data. Read them; they are not set.

AttributeUnitDescription
b:loc_name·Name

Related

← ElmComp Composite Model · ElmMdl Modelica Model →