ElmTow attributesPowerFactory Line Couplings

Every attribute of the PowerFactory Line Couplings (ElmTow): 79 input parameters and 136 result variables, with units and meaning. Copy a name into GetAttribute or SetAttribute.

What ElmTow is

Line couplings: the mutual coupling between line circuits that share towers, computed from a tower type.

Class
ElmTow, element class
PowerFactory name
Line Couplings
Attributes
79 input parameters and 136 result variables, in 6 calculations

Read and write ElmTow in Python

import powerfactory

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

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

obj = app.GetCalcRelevantObjects("*.ElmTow")[0]
obj.SetAttribute("outserv", 1)                # take it out of service
  • 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.

ElmTow 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
earthReturn·Earth return formula
iTransMode·Transposition
i_dist·Line Model
c_dist·Distributed Parameter
c_lumped·Lumped Parameter (PI)
i_const_rms·Travelling wave
lossModel_rms·Loss model
iopt_tem_rms·Temperature dependency
i_model·Distributed parameter line model
lossModel_emt·Loss model
iterVFZ·Max. number of iterations
iterVFA·Max. number of iterations
polesVFZ·Max. number of poles
polesVFA·Max. number of poles
outputPoles·Output poles
dcCorr·Apply DC correction
tuneDelays·Fine-tune delays
methodVFZ·Number of poles
methodVFA·Number of poles
fd_model·Line Model
fd_fit·Fit
iopt_tem·Temperature Dependency
freqDepPiModel·Lumped parameter line model
numStates·Max. model order
modelPiSec·Circuit configuration
fittingMethod·Fitting method
numPiSec·Number of cascaded PI sections
rearth·Earth resistivity
gshuntuS/kmShunt conductance
fminHzMin. Frequency of Parameter Fitting
fmaxHzMax. Frequency of Parameter Fitting
ftauHzFrequency for Parameter Approximation
tolBode%Tolerance for Bode Approximation
maxErrVFYSRMS error
maxErrVFZOhmRMS error
maxErrVFA·RMS error
stMarginZ·Stability margin
stMarginA·Stability margin
appr_modif·Modified
towdistmDistance
sag_emMax.Sag
dpolar·Polarity
sag_cmMax.Sag
dphasing·Phasing
pzsOhmSurge Impedance
adcp.u.Wave Propagation, DC
tmat·Transformation Matrix Tv
desc·Description
pRoute·RouteObject: ElmRoute
pGeo·TypeObject: TypTow,TypGeo
plines·CircuitObject: ElmLne,ElmLneroute
ngeo·Number of overhead line systems
cCon_e·TypeObject: TypCon
cCon_c·TypeObject: TypCon
ctransp·Transposition
desc_c·Description
ci_model·Distributed parameter line model
cdisp_mode·Display Data for Mode
cdisp_col·Display data for phase matrix index
cdisp_row·Display data for phase matrix row
cdisp_eig·Display data for eigenvalue
c_pz·Z, N° Poles/Zeros
c_pa·A, N° Poles
c_za·A, N° Zeros
c_pzsOhmSurge Impedance, HF
c_adcp.u.Wave Propagation, DC
c_pTausTravel Time
c_paULM·A, Number of poles
c_aAtDCp.u.Wave propagation, DC
c_pTadusTravel Time
c_pTadULMusTravel time
c_freqDepPiModel·Lumped parameter line model

ElmTow load flow results

Read after ComLdf with GetAttribute. c: calculation parameter.

AttributeUnitDescription
c:zlineOhmImpedance matrix
c:ylineSAdmittance matrix
c:rlinedcOhmResistance matrix
c:glinedcSConductance matrix
c:yZlineSInversion of impedance matrix
c:frnomHzNominal frequency
c:frnomDCHzNominal frequency, DC
c:hpirad/sNominal angular frequency
c:rlineOhmResistance matrix
c:glineSConductance matrix
c:rline_1OhmResistance matrix
c:gline_1SConductance matrix
c:rline_2OhmResistance matrix
c:gline_2SConductance matrix
c:zline_1OhmImpedance matrix
c:yline_1SAdmittance matrix
c:zline_2OhmImpedance matrix
c:yline_2SAdmittance matrix

ElmTow short-circuit results

Read after ComShc with GetAttribute. c: calculation parameter.

AttributeUnitDescription
c:zlineOhmImpedance matrix
c:ylineSAdmittance matrix
c:rlinedcOhmResistance matrix
c:glinedcSConductance matrix
c:yZlineSInversion of impedance matrix
c:frnomHzNominal frequency
c:frnomDCHzNominal frequency
c:hpirad/sNominal angular frequency
c:zline_1OhmImpedance matrix
c:yline_1SAdmittance matrix
c:zline_2OhmImpedance matrix
c:yline_2SAdmittance matrix

ElmTow rms simulation results

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

AttributeUnitDescription
c:zlineOhmImpedance matrix
c:ylineSAdmittance matrix
c:rlinedcOhmResistance matrix
c:glinedcSConductance matrix
c:yZlineSInversion of impedance matrix
c:frnomHzNominal frequency
c:frnomDCHzNominal frequency, DC
c:hpirad/sNominal angular frequency
c:llinedcHInductance
c:clinedcFLine Capacitance
c:rlineOhmResistance matrix
c:llineHInductance matrix
c:glineSConductance matrix
c:clineFCapacitance matrix
c:Rs1OhmResistance 1
c:Ls1HInductance 1
c:Rs2OhmResistance 2
c:Ls2HInductance 2
c:RsmOhmResistance 1-2
c:LsmHInductance 1-2
c:glneSShunt conductance
c:clneFShunt capacitance
c:rline_1OhmResistance matrix
c:gline_1SConductance matrix
c:rline_2OhmResistance matrix
c:gline_2SConductance matrix
c:zline_1OhmImpedance matrix
c:yline_1SAdmittance matrix
c:zline_2OhmImpedance matrix
c:yline_2SAdmittance matrix

ElmTow emt simulation results

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

AttributeUnitDescription
c:ylineSAdmittance matrix
c:frnomHzNominal frequency
c:frnomDCHzNominal frequency, DC
c:hpirad/sNominal angular frequency
c:rlineOhmResistance matrix
c:llineHInductance matrix
c:glineSConductance matrix
c:clineFCapacitance matrix
c:U1mkVVector of Modal Voltages, bus1
c:U2mkVVector of Modal Voltages, bus2
c:I1mkAVector of Modal Currents, bus1
c:I2mkAVector of Modal Currents, bus2
c:Rs1OhmResistance 1
c:Ls1HInductance 1
c:Rs2OhmResistance 2
c:Ls2HInductance 2
c:RsmOhmResistance 1-2
c:LsmHInductance 1-2
c:glneSShunt conductance
c:clneFShunt capacitance
c:rline_1OhmResistance matrix
c:gline_1SConductance matrix
c:rline_2OhmResistance matrix
c:gline_2SConductance matrix
c:lline_1HInductance matrix
c:lline_2HInductance matrix
c:cline_1FCapacitance matrix
c:cline_2FCapacitance matrix

Read after ComMod with GetAttribute. c: calculation parameter.

AttributeUnitDescription
c:zlineOhmImpedance matrix
c:ylineSAdmittance matrix
c:rlinedcOhmResistance matrix
c:glinedcSConductance matrix
c:yZlineSInversion of impedance matrix
c:frnomHzNominal frequency
c:frnomDCHzNominal frequency, DC
c:hpirad/sNominal angular frequency
c:llinedcHInductance
c:clinedcFLine Capacitance
c:rlineOhmResistance matrix
c:llineHInductance matrix
c:glineSConductance matrix
c:clineFCapacitance matrix
c:Rs1OhmResistance 1
c:Ls1HInductance 1
c:Rs2OhmResistance 2
c:Ls2HInductance 2
c:RsmOhmResistance 1-2
c:LsmHInductance 1-2
c:glneSShunt conductance
c:clneFShunt capacitance
c:rline_1OhmResistance matrix
c:gline_1SConductance matrix
c:rline_2OhmResistance matrix
c:gline_2SConductance matrix
c:zline_1OhmImpedance matrix
c:yline_1SAdmittance matrix
c:zline_2OhmImpedance matrix
c:yline_2SAdmittance matrix

ElmTow optimal power flow results

Read after ComOpf with GetAttribute. c: calculation parameter.

AttributeUnitDescription
c:zlineOhmImpedance matrix
c:ylineSAdmittance matrix
c:rlinedcOhmResistance matrix
c:glinedcSConductance matrix
c:yZlineSInversion of impedance matrix
c:frnomHzNominal frequency
c:frnomDCHzNominal frequency, DC
c:hpirad/sNominal angular frequency
c:rlineOhmResistance matrix
c:glineSConductance matrix
c:rline_1OhmResistance matrix
c:gline_1SConductance matrix
c:rline_2OhmResistance matrix
c:gline_2SConductance matrix
c:zline_1OhmImpedance matrix
c:yline_1SAdmittance matrix
c:zline_2OhmImpedance matrix
c:yline_2SAdmittance matrix

ElmTow basic data

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

AttributeUnitDescription
b:loc_name·Name

Related

← ElmSind Series Reactor · ElmTr2 2-Winding Transformer →