StaPll attributesPowerFactory PLL Phase/Frequency Measurement
Every attribute of the PowerFactory PLL Phase/Frequency Measurement (StaPll): 25 input parameters and 84 result variables, with units and meaning. Copy a name into GetAttribute or SetAttribute.
What StaPll is
A phase-locked loop (PLL) measurement device: it measures the phase angle and frequency at a terminal for dynamic models.
- Class
StaPll, element class- PowerFactory name
- PLL Phase/Frequency Measurement
- Attributes
- 25 input parameters and 84 result variables, in 3 calculations
Read and write StaPll in Python
import powerfactory
app = powerfactory.GetApplication() # GetApplicationExt() from outside PowerFactory
for obj in app.GetCalcRelevantObjects("*.StaPll"):
print(obj.loc_name, obj.GetAttribute("loc_name")) # Name
obj = app.GetCalcRelevantObjects("*.StaPll")[0]
obj.SetAttribute("outserv", 1) # switch it 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 parameters25
- RMS simulation results30
- EMT simulation results24
- Modal analysis results30
- Basic data1
StaPll input parameters
The element data, as typed in GetAttribute and SetAttribute (the e: prefix is optional). Setting one changes the model.
| Attribute | Unit | Description |
|---|---|---|
Ki | PI integration gain | PI integration gain |
Kp | PI proportional gain | PI proportional gain |
Ksogi | SOGI proportional gain | SOGI proportional gain |
T1 | ms | Low-pass filter time constant |
bw | rad/s | Bandwidth |
chr_name | Characteristic Name | Characteristic Name |
dat_src | Data source | Data source |
fmax | p.u. | Upper frequency limit |
fmin | p.u. | Lower frequency limit |
for_name | Foreign Key | Foreign Key |
gnrl_modby | Object modified by | Object modified by |
gnrl_modif | Object modified | Object modified |
iAstabint | A-stable integration algorithm | A-stable integration algorithm |
i_block | Voltage dependent blocking | Voltage dependent blocking |
i_dw | · | Set the angular frequency deviation to zero when blockedObject: Set the angular frequency deviation to zero when blocked |
i_model | PLL based on | PLL based on |
i_norm | Input voltage normalisation | Input voltage normalisation |
i_notch | Notch filter for oscillations at double nominal angular frequency | Notch filter for oscillations at double nominal angular frequency |
loc_name | Name | Name |
measuredPh | Measured phase | Measured phase |
nphase | No. of phases | No. of phases |
outserv | Out of Service | Out of Service |
pbusbar | · | Measurement pointObject: StaBar,ElmTerm,StaCubic |
umin | p.u. | Blocking voltage |
r:pbusbar | · | Measurement pointObject: StaBar,ElmTerm,StaCubic |
StaPll rms simulation results
Read after ComInc (RMS) with GetAttribute. c: calculation parameter, s: signal (state or model variable).
| Attribute | Unit | Description |
|---|---|---|
c:Phi | deg | Voltage angle |
c:dphi | rad | dphi |
c:dwlim | rad/s | dwlim |
c:dwmax | rad/s | Upper angular frequency deviation limit |
c:dwmin | rad/s | Lower angular frequency deviation limit |
c:frnom | Hz | Nominal frequency |
c:hpi | rad/s | Nominal angular frequency |
c:umin | p.u. | Blocking voltage |
c:vd | p.u. | vd |
c:vq | p.u. | vq |
s:Fmeas | Hz | OUT |
s:cosphi | OUT | cos(phi) |
s:fmeas | p.u. | OUT |
s:fref | p.u. | IN |
s:phiref | rad | STATE |
s:phiref:dt | rad/s | d/dt |
s:sinphi | OUT | sin(phi) |
s:uI | p.u. | IN |
s:uI_A | p.u. | IN |
s:uI_B | p.u. | IN |
s:uI_C | p.u. | IN |
s:uR | p.u. | IN |
s:uR_A | p.u. | IN |
s:uR_B | p.u. | IN |
s:uR_C | p.u. | IN |
s:umag | p.u. | SIGS |
s:xphi | rad | STATE |
s:xphi:dt | rad/s | d/dt |
s:xpi | STATE | State variable (PI-controller) |
s:xpi:dt | /s | d/dt |
StaPll emt simulation results
Read after ComInc (EMT) with GetAttribute. c: calculation parameter, s: signal (state or model variable).
| Attribute | Unit | Description |
|---|---|---|
c:Phi | deg | Voltage angle |
c:dphi | rad | dphi |
c:dwlim | rad/s | dwlim |
c:dwmax | rad/s | Upper angular frequency deviation limit |
c:dwmin | rad/s | Lower angular frequency deviation limit |
c:frnom | Hz | Nominal frequency |
c:hpi | rad/s | Nominal angular frequency |
c:umin | p.u. | Blocking voltage |
c:valpha_in | p.u. | Voltage input, alpha-component |
c:vbeta_in | p.u. | Voltage input, beta-component |
c:vd | p.u. | vd |
c:vq | p.u. | vq |
s:Fmeas | Hz | OUT |
s:cosphi | OUT | cos(phi) |
s:fmeas | p.u. | OUT |
s:sinphi | OUT | sin(phi) |
s:u_a | p.u. | IN |
s:u_b | p.u. | IN |
s:u_c | p.u. | IN |
s:umag | p.u. | SIGS |
s:xphi | rad | STATE |
s:xphi:dt | rad/s | d/dt |
s:xpi | STATE | State variable (PI-controller) |
s:xpi:dt | /s | d/dt |
StaPll modal analysis results
Read after ComMod with GetAttribute. c: calculation parameter, s: signal (state or model variable).
| Attribute | Unit | Description |
|---|---|---|
c:Phi | deg | Voltage angle |
c:dphi | rad | dphi |
c:dwlim | rad/s | dwlim |
c:dwmax | rad/s | Upper angular frequency deviation limit |
c:dwmin | rad/s | Lower angular frequency deviation limit |
c:frnom | Hz | Nominal frequency |
c:hpi | rad/s | Nominal angular frequency |
c:umin | p.u. | Blocking voltage |
c:vd | p.u. | vd |
c:vq | p.u. | vq |
s:Fmeas | Hz | OUT |
s:cosphi | OUT | cos(phi) |
s:fmeas | p.u. | OUT |
s:fref | p.u. | IN |
s:phiref | rad | STATE |
s:phiref:dt | rad/s | d/dt |
s:sinphi | OUT | sin(phi) |
s:uI | p.u. | IN |
s:uI_A | p.u. | IN |
s:uI_B | p.u. | IN |
s:uI_C | p.u. | IN |
s:uR | p.u. | IN |
s:uR_A | p.u. | IN |
s:uR_B | p.u. | IN |
s:uR_C | p.u. | IN |
s:umag | p.u. | SIGS |
s:xphi | rad | STATE |
s:xphi:dt | rad/s | d/dt |
s:xpi | STATE | State variable (PI-controller) |
s:xpi:dt | /s | d/dt |
StaPll basic data
b: values are worked out from the input data. Read them; they are not set.
| Attribute | Unit | Description |
|---|---|---|
b:loc_name | Name | Name |