DynLoad#
Dynamic load group.
Common Parameters: u, name
ZIP#
ZIP load model (polynomial load). This model is initialized after power flow.
Please check the config of PQ to avoid double counting. If this ZIP model is in use, one should typically set p2p=1.0 and q2q=1.0 while leaving the others (p2i, p2z, q2i, q2z, and pq2z) as zeros. This setting allows one to impose the desired powers by the static PQ and to convert them based on the percentage specified in the ZIP.
The percentages for active power, (kpp, kpi, and kpz) must sum up to 100. Otherwise, initialization will fail. The same applies to the reactive power percentages.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
pq |
idx of the PQ to replace |
mandatory |
|||
kpp |
\(K_{pp}\) |
Percentage of active power |
mandatory |
||
kpi |
\(K_{pi}\) |
Percentage of active current |
mandatory |
||
kpz |
\(K_{pz}\) |
Percentage of conductance |
mandatory |
||
kqp |
\(K_{qp}\) |
Percentage of reactive power |
mandatory |
||
kqi |
\(K_{qi}\) |
Percentage of reactive current |
mandatory |
||
kqz |
\(K_{qz}\) |
Percentage of susceptance |
mandatory |
||
ue |
\(u_e\) |
effective online status |
0 |
||
bus |
retrieved bux idx |
0 |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
a |
\(a\) |
ExtAlgeb |
|||
v |
\(v\) |
ExtAlgeb |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
a |
\(a\) |
ExtAlgeb |
|
v |
\(v\) |
ExtAlgeb |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
a |
\(a\) |
ExtAlgeb |
\(\pi_{0} v + pp_{0} + pz_{0} v^{2}\) |
v |
\(v\) |
ExtAlgeb |
\(qi_{0} v + qp_{0} + qz_{0} v^{2}\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
kps |
\(K_{psum}\) |
\(kpi + kpp + kpz\) |
ConstService |
kqs |
\(K_{qsum}\) |
\(kqi + kqp + kqz\) |
ConstService |
rpp |
\(r_{pp}\) |
\(\frac{kpp u}{100}\) |
ConstService |
rpi |
\(r_{pi}\) |
\(\frac{kpi u}{100}\) |
ConstService |
rpz |
\(r_{pz}\) |
\(\frac{kpz u}{100}\) |
ConstService |
rqp |
\(r_{qp}\) |
\(\frac{kqp u}{100}\) |
ConstService |
rqi |
\(r_{qi}\) |
\(\frac{kqi u}{100}\) |
ConstService |
rqz |
\(r_{qz}\) |
\(\frac{kqz u}{100}\) |
ConstService |
pp0 |
\(P_{p0}\) |
\(p_{0} rpp\) |
ConstService |
pi0 |
\(P_{i0}\) |
\(\frac{p_{0} rpi}{v_{0}}\) |
ConstService |
pz0 |
\(P_{z0}\) |
\(\frac{p_{0} rpz}{v_{0}^{2}}\) |
ConstService |
qp0 |
\(Q_{p0}\) |
\(q_{0} rqp\) |
ConstService |
qi0 |
\(Q_{i0}\) |
\(\frac{q_{0} rqi}{v_{0}}\) |
ConstService |
qz0 |
\(Q_{z0}\) |
\(\frac{q_{0} rqz}{v_{0}^{2}}\) |
ConstService |
Config Fields in [ZIP]
Option |
Symbol |
Value |
Info |
Accepted values |
|---|---|---|---|---|
allow_adjust |
1 |
allow adjusting upper or lower limits |
(0, 1) |
|
adjust_lower |
0 |
adjust lower limit |
(0, 1) |
|
adjust_upper |
1 |
adjust upper limit |
(0, 1) |
FLoad#
Voltage and frequency dependent load.
FLoad replaces the linked PQ load (set to u=0) and computes power as
P = pv0 * v^ap * f^bp, Q = qv0 * v^aq * f^bq.
pv0 and qv0 are ConstService values computed once at TDS init
from the PQ's solved power flow values (Ppf, Qpf). To adjust
power injection during TDS, alter pv0/qv0 on FLoad directly:
Alter(model='FLoad', src='pv0', dev=fl_idx, t=5, method='+', amount=0.1)
Altering the linked PQ's Ppf has no effect since PQ is disabled.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
pq |
idx of the PQ to replace |
mandatory |
|||
busf |
optional idx of the BusFreq device to use |
||||
kp |
active power percentage |
100 |
% |
||
kq |
active power percentage |
100 |
% |
||
Tf |
filter time constant |
0.020 |
s |
non_negative |
|
ap |
active power voltage exponent |
1 |
|||
aq |
reactive power voltage exponent |
0 |
|||
bp |
active power frequency exponent |
0 |
|||
bq |
reactive power frequency exponent |
0 |
|||
ue |
\(u_e\) |
effective online status |
0 |
||
bus |
0 |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
f |
\(f\) |
ExtAlgeb |
|||
a |
\(a\) |
ExtAlgeb |
|||
v |
\(v\) |
ExtAlgeb |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
f |
\(f\) |
ExtAlgeb |
|
a |
\(a\) |
ExtAlgeb |
|
v |
\(v\) |
ExtAlgeb |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
f |
\(f\) |
ExtAlgeb |
\(0\) |
a |
\(a\) |
ExtAlgeb |
\(f^{bp} pv_{0} v^{ap}\) |
v |
\(v\) |
ExtAlgeb |
\(f^{bq} qv_{0} v^{aq}\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
pv0 |
\(pv0\) |
\(\frac{kp p_{0} u v_{0}^{- ap}}{100}\) |
ConstService |
qv0 |
\(qv0\) |
\(\frac{kq q_{0} u v_{0}^{- aq}}{100}\) |
ConstService |
Config Fields in [FLoad]
Option |
Symbol |
Value |
Info |
Accepted values |
|---|---|---|---|---|
allow_adjust |
1 |
allow adjusting upper or lower limits |
(0, 1) |
|
adjust_lower |
0 |
adjust lower limit |
(0, 1) |
|
adjust_upper |
1 |
adjust upper limit |
(0, 1) |