DGProtection#
Protection model for DG.
Common Parameters: u, name
Available models: DGPRCT1, DGPRCTExt
DGPRCT1#
DGPRCT1 model, follow IEEE-1547-2018. DGPRCT stands for DG protection.
A demo is provided: examples/demonstration/1.1 demo_DGPRCT1.ipynb
Target device (limited to DG group) Psum and Qsum will decrease to zero
immediately when frequency/voltage protection flag is raised. Once the lock is
released, Psum and Qsum will return to normal immediately.
DG group base model PVD1 already has a degrading function which is used to
degrade output under abnormal condition. it is recommended to turn it off by setting
recflag = 0.
fen and Ven are protection enabling parameters. 1/0 is on/off.
ue is lock flag signal.
It should be noted that, the lock only lock the fHz (frequency read value)
of DG model. The source values (which come from BusFreq f remain unchanged.)
Protection sensors (e.g., IAWfl1) are instances of IntergratorAntiWindup. All
the protection sensors will be reset after ue returns to 0.
Resetting action takes Tres to finish.
The model does not check the shedding points sequence.
The input parameters are required to satisfy fl3 < fl2 < fl1 < fu1 < fu2 < fu3,
and ul4 < ul3 < ul2 < ul1 < uu1 < uu2 < uu3.
Default settings:
Frequency (Hz):
(fl3, fl2), Tfl2 [(50.0, 57.5), 10s]
(fl2, fl1), Tfl1 [(57.5, 59.2), 300s]
(fu1, fu2), Tfu1 [(60.5, 61.5), 300s]
(fu2, fu3), Tfu2 [(61.5, 70.0), 10s]
Voltage (p.u.):
(vl4, vl3), Tvl3 [(0.10, 0.45), 0.16s]
(vl3, vl2), Tvl2 [(0.45, 0.60), 1s]
(vl2, vl1), Tvl1 [(0.60, 0.88), 2s]
(vu1, vu2), Tvu1 [(1.10, 1.20), 1s]
(vu2, vu3), Tvu2 [(1.20, 2.00), 0.16s]
Reference:
NERC. Bulk Power System Reliability Perspectives on the Adoption of IEEE 1547-2018. March 2020. Available:
https://www.nerc.com/comm/PC_Reliability_Guidelines_DL/Guideline_IEEE_1547-2018_BPS_Perspectives.pdf
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
dev |
idx of the target device |
mandatory |
|||
busfreq |
Target device interface bus measurement device idx |
||||
fen |
\(fen\) |
Frequency deviation protection enable. 1 for enable, 0 for disable. |
1 |
||
Ven |
\(Ven\) |
Voltage deviation protection enable. 1 for enable, 0 for disable. |
0 |
||
fl3 |
\(fl3\) |
Under frequency shadding point 3 |
50 |
Hz |
|
fl2 |
\(fl2\) |
Over frequency shadding point 2 |
57.500 |
Hz |
|
fl1 |
\(fl1\) |
Under frequency shadding point 1 |
59.200 |
Hz |
|
fu1 |
\(fu1\) |
Over frequency shadding point 1 |
60.500 |
Hz |
|
fu2 |
\(fu2\) |
Over frequency shadding point 2 |
61.500 |
Hz |
|
fu3 |
\(fu3\) |
Over frequency shadding point 3 |
70 |
Hz |
|
Tfl1 |
\(T_{fl1}\) |
Stand time for (fl2, fl1) |
300 |
non_negative |
|
Tfl2 |
\(T_{fl2}\) |
Stand time for (fl3, fl2) |
10 |
non_negative |
|
Tfu1 |
\(T_{fu1}\) |
Stand time for (fu1, fu2) |
300 |
non_negative |
|
Tfu2 |
\(T_{fu2}\) |
Stand time for (fu2, fu3) |
10 |
non_negative |
|
vl4 |
\(vl4\) |
Under voltage shadding point 4 |
0.100 |
p.u. |
|
vl3 |
\(vl3\) |
Under voltage shadding point 3 |
0.450 |
p.u. |
|
vl2 |
\(vl2\) |
Under voltage shadding point 2 |
0.600 |
p.u. |
|
vl1 |
\(vl1\) |
Under voltage shadding point 1 |
0.880 |
p.u. |
|
vu1 |
\(vu1\) |
Over voltage shadding point 1 |
1.100 |
p.u. |
|
vu2 |
\(vu2\) |
Over voltage shadding point 2 |
1.200 |
p.u. |
|
vu3 |
\(vu3\) |
Over voltage shadding point 3 |
2 |
p.u. |
|
Tvl1 |
\(T_{vl1}\) |
Stand time for (vl2, vl1) |
2 |
non_negative |
|
Tvl2 |
\(T_{vl2}\) |
Stand time for (vl3, vl2) |
1 |
non_negative |
|
Tvl3 |
\(T_{vl3}\) |
Stand time for (vl4, vl3) |
0.160 |
non_negative |
|
Tvu1 |
\(T_{vu1}\) |
Stand time for (vu1, vu2) |
1 |
non_negative |
|
Tvu2 |
\(T_{vu2}\) |
Stand time for (vu2, vu3) |
0.160 |
non_negative |
|
Tres |
Integrator reset time |
0.050 |
|||
bus |
0 |
||||
fn |
0 |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
IAWfl1_y |
\(IAWfl_{1 y}\) |
State |
AW Integrator output |
v_str |
|
IAWfl2_y |
\(IAWfl_{2 y}\) |
State |
AW Integrator output |
v_str |
|
IAWfu1_y |
\(IAWfu_{1 y}\) |
State |
AW Integrator output |
v_str |
|
IAWfu2_y |
\(IAWfu_{2 y}\) |
State |
AW Integrator output |
v_str |
|
IAWVl1_y |
\(IAWVl_{1 y}\) |
State |
AW Integrator output |
v_str |
|
IAWVl2_y |
\(IAWVl_{2 y}\) |
State |
AW Integrator output |
v_str |
|
IAWVl3_y |
\(IAWVl_{3 y}\) |
State |
AW Integrator output |
v_str |
|
IAWVu1_y |
\(IAWVu_{1 y}\) |
State |
AW Integrator output |
v_str |
|
IAWVu2_y |
\(IAWVu_{2 y}\) |
State |
AW Integrator output |
v_str |
|
fHz |
\(fHz\) |
Algeb |
frequency in Hz |
v_str |
|
dsum |
\(dsum\) |
Algeb |
lock signal summation |
v_str |
|
ue |
\(ue\) |
Algeb |
lock flag |
v_str |
|
f |
\(f\) |
ExtAlgeb |
DG frequency read value |
p.u. |
|
fin |
\(fin\) |
ExtAlgeb |
original f from DG |
||
fHzl |
\(fHzl\) |
ExtAlgeb |
Frequency measure lock |
||
Pext |
\(Pext\) |
ExtAlgeb |
original Pext from DG |
||
Pref |
\(Pref\) |
ExtAlgeb |
original Pref from DG |
||
Pdrp |
\(Pdrp\) |
ExtAlgeb |
original Pdrp from DG |
||
Psum |
\(Psum\) |
ExtAlgeb |
Active power lock |
||
Qdrp |
\(Qdrp\) |
ExtAlgeb |
original Qdrp from DG |
||
Qref |
\(Qref\) |
ExtAlgeb |
original Qref from DG |
||
Qsum |
\(Qsum\) |
ExtAlgeb |
Reactive power lock |
||
v |
\(v\) |
ExtAlgeb |
Bus voltage |
p.u. |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
IAWfl1_y |
\(IAWfl_{1 y}\) |
State |
\(0\) |
IAWfl2_y |
\(IAWfl_{2 y}\) |
State |
\(0\) |
IAWfu1_y |
\(IAWfu_{1 y}\) |
State |
\(0\) |
IAWfu2_y |
\(IAWfu_{2 y}\) |
State |
\(0\) |
IAWVl1_y |
\(IAWVl_{1 y}\) |
State |
\(0\) |
IAWVl2_y |
\(IAWVl_{2 y}\) |
State |
\(0\) |
IAWVl3_y |
\(IAWVl_{3 y}\) |
State |
\(0\) |
IAWVu1_y |
\(IAWVu_{1 y}\) |
State |
\(0\) |
IAWVu2_y |
\(IAWVu_{2 y}\) |
State |
\(0\) |
fHz |
\(fHz\) |
Algeb |
\(f fn\) |
dsum |
\(dsum\) |
Algeb |
\(0\) |
ue |
\(ue\) |
Algeb |
\(0\) |
f |
\(f\) |
ExtAlgeb |
|
fin |
\(fin\) |
ExtAlgeb |
|
fHzl |
\(fHzl\) |
ExtAlgeb |
|
Pext |
\(Pext\) |
ExtAlgeb |
|
Pref |
\(Pref\) |
ExtAlgeb |
|
Pdrp |
\(Pdrp\) |
ExtAlgeb |
|
Psum |
\(Psum\) |
ExtAlgeb |
|
Qdrp |
\(Qdrp\) |
ExtAlgeb |
|
Qref |
\(Qref\) |
ExtAlgeb |
|
Qsum |
\(Qsum\) |
ExtAlgeb |
|
v |
\(v\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
IAWfl1_y |
\(IAWfl_{1 y}\) |
State |
\(Lfl_{1 zi} \left(1 - res\right) - \frac{Tfl_{1} res}{Tres}\) |
\(1\) |
IAWfl2_y |
\(IAWfl_{2 y}\) |
State |
\(Lfl_{2 zi} \left(1 - res\right) - \frac{Tfl_{2} res}{Tres}\) |
\(1\) |
IAWfu1_y |
\(IAWfu_{1 y}\) |
State |
\(Lfu_{1 zi} \left(1 - res\right) - \frac{Tfu_{1} res}{Tres}\) |
\(1\) |
IAWfu2_y |
\(IAWfu_{2 y}\) |
State |
\(Lfl_{2 zi} \left(1 - res\right) - \frac{Tfu_{2} res}{Tres}\) |
\(1\) |
IAWVl1_y |
\(IAWVl_{1 y}\) |
State |
\(LVl_{1 zi} \left(1 - res\right) - \frac{Tvl_{1} res}{Tres}\) |
\(1\) |
IAWVl2_y |
\(IAWVl_{2 y}\) |
State |
\(LVl_{2 zi} \left(1 - res\right) - \frac{Tvl_{2} res}{Tres}\) |
\(1\) |
IAWVl3_y |
\(IAWVl_{3 y}\) |
State |
\(LVl_{2 zi} \left(1 - res\right) - \frac{Tvl_{3} res}{Tres}\) |
\(1\) |
IAWVu1_y |
\(IAWVu_{1 y}\) |
State |
\(LVu_{1 zi} \left(1 - res\right) - \frac{Tvu_{1} res}{Tres}\) |
\(1\) |
IAWVu2_y |
\(IAWVu_{2 y}\) |
State |
\(LVu_{2 zi} \left(1 - res\right) - \frac{Tvu_{2} res}{Tres}\) |
\(1\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
fHz |
\(fHz\) |
Algeb |
\(f fn - fHz\) |
dsum |
\(dsum\) |
Algeb |
\(Ven \left(IAWVl_{1 lim zu} LVl_{1 zi} + IAWVl_{2 lim zu} LVl_{2 zi} + IAWVl_{3 lim zu} LVl_{3 zi} + IAWVu_{1 lim zu} LVu_{1 zi} + IAWVu_{2 lim zu} LVu_{2 zi}\right) - dsum + fen \left(IAWfl_{1 lim zu} Lfl_{1 zi} + IAWfl_{2 lim zu} Lfl_{2 zi} + IAWfu_{1 lim zu} Lfu_{1 zi} + IAWfu_{2 lim zu} Lfu_{2 zi}\right)\) |
ue |
\(ue\) |
Algeb |
\(Ldsum_{zu} - ue\) |
f |
\(f\) |
ExtAlgeb |
\(0\) |
fin |
\(fin\) |
ExtAlgeb |
\(0\) |
fHzl |
\(fHzl\) |
ExtAlgeb |
\(- f fn ue\) |
Pext |
\(Pext\) |
ExtAlgeb |
\(0\) |
Pref |
\(Pref\) |
ExtAlgeb |
\(0\) |
Pdrp |
\(Pdrp\) |
ExtAlgeb |
\(0\) |
Psum |
\(Psum\) |
ExtAlgeb |
\(- ue \left(Pdrp + Pext + Pref\right)\) |
Qdrp |
\(Qdrp\) |
ExtAlgeb |
\(0\) |
Qref |
\(Qref\) |
ExtAlgeb |
\(0\) |
Qsum |
\(Qsum\) |
ExtAlgeb |
\(- ue \left(Qdrp + Qref\right)\) |
v |
\(v\) |
ExtAlgeb |
\(0\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ltu |
\(ltu\) |
\(0.8\) |
ConstService |
ltl |
\(ltl\) |
\(0.2\) |
ConstService |
zero |
\(zero\) |
\(0\) |
ConstService |
res |
\(res\) |
\(0\) |
ExtendedEvent |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
Ldsum |
\(Ldsum\) |
Limiter |
lock signal comparer, zu is to act |
Lfl1 |
\(Lfl1\) |
Limiter |
Frequency comparer for (fl3, fl1) |
Lfl2 |
\(Lfl2\) |
Limiter |
Frequency comparer for (fl3, fl2) |
Lfu1 |
\(Lfu1\) |
Limiter |
Frequency comparer for (fu1, fu3) |
Lfu2 |
\(Lfu2\) |
Limiter |
Frequency comparer for (fu2, fu3) |
IAWfl1_lim |
\(lim_{IAWfl1}\) |
AntiWindup |
Limiter in integrator |
IAWfl2_lim |
\(lim_{IAWfl2}\) |
AntiWindup |
Limiter in integrator |
IAWfu1_lim |
\(lim_{IAWfu1}\) |
AntiWindup |
Limiter in integrator |
IAWfu2_lim |
\(lim_{IAWfu2}\) |
AntiWindup |
Limiter in integrator |
LVl1 |
\(LVl1\) |
Limiter |
Voltage comparer for (vl4, vl1) |
LVl2 |
\(LVl2\) |
Limiter |
Voltage comparer for (vl4, vl2) |
LVl3 |
\(LVl3\) |
Limiter |
Voltage comparer for (vl4, vl3) |
LVu1 |
\(LVu1\) |
Limiter |
Voltage comparer for (vu1, vu3) |
LVu2 |
\(LVu2\) |
Limiter |
Voltage comparer for (vu2, vu3) |
IAWVl1_lim |
\(lim_{IAWVl1}\) |
AntiWindup |
Limiter in integrator |
IAWVl2_lim |
\(lim_{IAWVl2}\) |
AntiWindup |
Limiter in integrator |
IAWVl3_lim |
\(lim_{IAWVl3}\) |
AntiWindup |
Limiter in integrator |
IAWVu1_lim |
\(lim_{IAWVu1}\) |
AntiWindup |
Limiter in integrator |
IAWVu2_lim |
\(lim_{IAWVu2}\) |
AntiWindup |
Limiter in integrator |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
IAWfl1 |
\(IAWfl1\) |
IntegratorAntiWindup |
condition check for (fl3, fl1) |
IAWfl2 |
\(IAWfl2\) |
IntegratorAntiWindup |
condition check for (fl3, fl2) |
IAWfu1 |
\(IAWfu1\) |
IntegratorAntiWindup |
condition check for (fu1, fu3) |
IAWfu2 |
\(IAWfu2\) |
IntegratorAntiWindup |
condition check for (fu2, fu3) |
IAWVl1 |
\(IAWVl1\) |
IntegratorAntiWindup |
condition check for (Vl3, Vl1) |
IAWVl2 |
\(IAWVl2\) |
IntegratorAntiWindup |
condition check for (Vl3, Vl2) |
IAWVl3 |
\(IAWVl3\) |
IntegratorAntiWindup |
condition check for (Vl3, Vl2) |
IAWVu1 |
\(IAWVu1\) |
IntegratorAntiWindup |
condition check for (Vu1, Vu3) |
IAWVu2 |
\(IAWVu2\) |
IntegratorAntiWindup |
condition check for (Vu2, Vu3) |
Config Fields in [DGPRCT1]
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) |
DGPRCTExt#
DGPRCT External model, follow IEEE-1547-2018. DGPRCT stands for DG protection.
Similar to DGPRCT1, but the measured voltage can be manipulated.
A demo is provided: examples/demonstration/1.2 demo_DGPRCTExt.ipynb
This model can be applied to co-simulation, where you can input the external votage signal into ANDES. If no extertal value is applied, the votalge will remain as the initialized value.
Target device (limited to DG group) Psum and Qsum will decrease to zero
immediately when frequency/voltage protection flag is raised. Once the lock is
released, Psum and Qsum will return to normal immediately.
DG group base model PVD1 already has a degrading function which is used to
degrade output under abnormal condition. it is recommended to turn it off by setting
recflag = 0.
fen and Ven are protection enabling parameters. 1/0 is on/off.
ue is lock flag signal.
It should be noted that, the lock only lock the fHz (frequency read value)
of DG model. The source values (which come from BusFreq f remain unchanged.)
Protection sensors (e.g., IAWfl1) are instances of IntergratorAntiWindup. All
the protection sensors will be reset after ue returns to 0.
Resetting action takes Tres to finish.
The model does not check the shedding points sequence.
The input parameters are required to satisfy fl3 < fl2 < fl1 < fu1 < fu2 < fu3,
and ul4 < ul3 < ul2 < ul1 < uu1 < uu2 < uu3.
Default settings:
Frequency (Hz):
(fl3, fl2), Tfl2 [(50.0, 57.5), 10s]
(fl2, fl1), Tfl1 [(57.5, 59.2), 300s]
(fu1, fu2), Tfu1 [(60.5, 61.5), 300s]
(fu2, fu3), Tfu2 [(61.5, 70.0), 10s]
Voltage (p.u.):
(vl4, vl3), Tvl3 [(0.10, 0.45), 0.16s]
(vl3, vl2), Tvl2 [(0.45, 0.60), 1s]
(vl2, vl1), Tvl1 [(0.60, 0.88), 2s]
(vu1, vu2), Tvu1 [(1.10, 1.20), 1s]
(vu2, vu3), Tvu2 [(1.20, 2.00), 0.16s]
Reference:
NERC. Bulk Power System Reliability Perspectives on the Adoption of IEEE 1547-2018. March 2020. Available:
https://www.nerc.com/comm/PC_Reliability_Guidelines_DL/Guideline_IEEE_1547-2018_BPS_Perspectives.pdf
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
dev |
idx of the target device |
mandatory |
|||
busfreq |
Target device interface bus measurement device idx |
||||
fen |
\(fen\) |
Frequency deviation protection enable. 1 for enable, 0 for disable. |
1 |
||
Ven |
\(Ven\) |
Voltage deviation protection enable. 1 for enable, 0 for disable. |
0 |
||
fl3 |
\(fl3\) |
Under frequency shadding point 3 |
50 |
Hz |
|
fl2 |
\(fl2\) |
Over frequency shadding point 2 |
57.500 |
Hz |
|
fl1 |
\(fl1\) |
Under frequency shadding point 1 |
59.200 |
Hz |
|
fu1 |
\(fu1\) |
Over frequency shadding point 1 |
60.500 |
Hz |
|
fu2 |
\(fu2\) |
Over frequency shadding point 2 |
61.500 |
Hz |
|
fu3 |
\(fu3\) |
Over frequency shadding point 3 |
70 |
Hz |
|
Tfl1 |
\(T_{fl1}\) |
Stand time for (fl2, fl1) |
300 |
non_negative |
|
Tfl2 |
\(T_{fl2}\) |
Stand time for (fl3, fl2) |
10 |
non_negative |
|
Tfu1 |
\(T_{fu1}\) |
Stand time for (fu1, fu2) |
300 |
non_negative |
|
Tfu2 |
\(T_{fu2}\) |
Stand time for (fu2, fu3) |
10 |
non_negative |
|
vl4 |
\(vl4\) |
Under voltage shadding point 4 |
0.100 |
p.u. |
|
vl3 |
\(vl3\) |
Under voltage shadding point 3 |
0.450 |
p.u. |
|
vl2 |
\(vl2\) |
Under voltage shadding point 2 |
0.600 |
p.u. |
|
vl1 |
\(vl1\) |
Under voltage shadding point 1 |
0.880 |
p.u. |
|
vu1 |
\(vu1\) |
Over voltage shadding point 1 |
1.100 |
p.u. |
|
vu2 |
\(vu2\) |
Over voltage shadding point 2 |
1.200 |
p.u. |
|
vu3 |
\(vu3\) |
Over voltage shadding point 3 |
2 |
p.u. |
|
Tvl1 |
\(T_{vl1}\) |
Stand time for (vl2, vl1) |
2 |
non_negative |
|
Tvl2 |
\(T_{vl2}\) |
Stand time for (vl3, vl2) |
1 |
non_negative |
|
Tvl3 |
\(T_{vl3}\) |
Stand time for (vl4, vl3) |
0.160 |
non_negative |
|
Tvu1 |
\(T_{vu1}\) |
Stand time for (vu1, vu2) |
1 |
non_negative |
|
Tvu2 |
\(T_{vu2}\) |
Stand time for (vu2, vu3) |
0.160 |
non_negative |
|
Tres |
Integrator reset time |
0.050 |
|||
bus |
0 |
||||
fn |
0 |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
IAWfl1_y |
\(IAWfl_{1 y}\) |
State |
AW Integrator output |
v_str |
|
IAWfl2_y |
\(IAWfl_{2 y}\) |
State |
AW Integrator output |
v_str |
|
IAWfu1_y |
\(IAWfu_{1 y}\) |
State |
AW Integrator output |
v_str |
|
IAWfu2_y |
\(IAWfu_{2 y}\) |
State |
AW Integrator output |
v_str |
|
IAWVl1_y |
\(IAWVl_{1 y}\) |
State |
AW Integrator output |
v_str |
|
IAWVl2_y |
\(IAWVl_{2 y}\) |
State |
AW Integrator output |
v_str |
|
IAWVl3_y |
\(IAWVl_{3 y}\) |
State |
AW Integrator output |
v_str |
|
IAWVu1_y |
\(IAWVu_{1 y}\) |
State |
AW Integrator output |
v_str |
|
IAWVu2_y |
\(IAWVu_{2 y}\) |
State |
AW Integrator output |
v_str |
|
fHz |
\(fHz\) |
Algeb |
frequency in Hz |
v_str |
|
dsum |
\(dsum\) |
Algeb |
lock signal summation |
v_str |
|
ue |
\(ue\) |
Algeb |
lock flag |
v_str |
|
f |
\(f\) |
ExtAlgeb |
DG frequency read value |
p.u. |
|
fin |
\(fin\) |
ExtAlgeb |
original f from DG |
||
fHzl |
\(fHzl\) |
ExtAlgeb |
Frequency measure lock |
||
Pext |
\(Pext\) |
ExtAlgeb |
original Pext from DG |
||
Pref |
\(Pref\) |
ExtAlgeb |
original Pref from DG |
||
Pdrp |
\(Pdrp\) |
ExtAlgeb |
original Pdrp from DG |
||
Psum |
\(Psum\) |
ExtAlgeb |
Active power lock |
||
Qdrp |
\(Qdrp\) |
ExtAlgeb |
original Qdrp from DG |
||
Qref |
\(Qref\) |
ExtAlgeb |
original Qref from DG |
||
Qsum |
\(Qsum\) |
ExtAlgeb |
Reactive power lock |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
IAWfl1_y |
\(IAWfl_{1 y}\) |
State |
\(0\) |
IAWfl2_y |
\(IAWfl_{2 y}\) |
State |
\(0\) |
IAWfu1_y |
\(IAWfu_{1 y}\) |
State |
\(0\) |
IAWfu2_y |
\(IAWfu_{2 y}\) |
State |
\(0\) |
IAWVl1_y |
\(IAWVl_{1 y}\) |
State |
\(0\) |
IAWVl2_y |
\(IAWVl_{2 y}\) |
State |
\(0\) |
IAWVl3_y |
\(IAWVl_{3 y}\) |
State |
\(0\) |
IAWVu1_y |
\(IAWVu_{1 y}\) |
State |
\(0\) |
IAWVu2_y |
\(IAWVu_{2 y}\) |
State |
\(0\) |
fHz |
\(fHz\) |
Algeb |
\(f fn\) |
dsum |
\(dsum\) |
Algeb |
\(0\) |
ue |
\(ue\) |
Algeb |
\(0\) |
f |
\(f\) |
ExtAlgeb |
|
fin |
\(fin\) |
ExtAlgeb |
|
fHzl |
\(fHzl\) |
ExtAlgeb |
|
Pext |
\(Pext\) |
ExtAlgeb |
|
Pref |
\(Pref\) |
ExtAlgeb |
|
Pdrp |
\(Pdrp\) |
ExtAlgeb |
|
Psum |
\(Psum\) |
ExtAlgeb |
|
Qdrp |
\(Qdrp\) |
ExtAlgeb |
|
Qref |
\(Qref\) |
ExtAlgeb |
|
Qsum |
\(Qsum\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
IAWfl1_y |
\(IAWfl_{1 y}\) |
State |
\(Lfl_{1 zi} \left(1 - res\right) - \frac{Tfl_{1} res}{Tres}\) |
\(1\) |
IAWfl2_y |
\(IAWfl_{2 y}\) |
State |
\(Lfl_{2 zi} \left(1 - res\right) - \frac{Tfl_{2} res}{Tres}\) |
\(1\) |
IAWfu1_y |
\(IAWfu_{1 y}\) |
State |
\(Lfu_{1 zi} \left(1 - res\right) - \frac{Tfu_{1} res}{Tres}\) |
\(1\) |
IAWfu2_y |
\(IAWfu_{2 y}\) |
State |
\(Lfl_{2 zi} \left(1 - res\right) - \frac{Tfu_{2} res}{Tres}\) |
\(1\) |
IAWVl1_y |
\(IAWVl_{1 y}\) |
State |
\(LVl_{1 zi} \left(1 - res\right) - \frac{Tvl_{1} res}{Tres}\) |
\(1\) |
IAWVl2_y |
\(IAWVl_{2 y}\) |
State |
\(LVl_{2 zi} \left(1 - res\right) - \frac{Tvl_{2} res}{Tres}\) |
\(1\) |
IAWVl3_y |
\(IAWVl_{3 y}\) |
State |
\(LVl_{2 zi} \left(1 - res\right) - \frac{Tvl_{3} res}{Tres}\) |
\(1\) |
IAWVu1_y |
\(IAWVu_{1 y}\) |
State |
\(LVu_{1 zi} \left(1 - res\right) - \frac{Tvu_{1} res}{Tres}\) |
\(1\) |
IAWVu2_y |
\(IAWVu_{2 y}\) |
State |
\(LVu_{2 zi} \left(1 - res\right) - \frac{Tvu_{2} res}{Tres}\) |
\(1\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
fHz |
\(fHz\) |
Algeb |
\(f fn - fHz\) |
dsum |
\(dsum\) |
Algeb |
\(Ven \left(IAWVl_{1 lim zu} LVl_{1 zi} + IAWVl_{2 lim zu} LVl_{2 zi} + IAWVl_{3 lim zu} LVl_{3 zi} + IAWVu_{1 lim zu} LVu_{1 zi} + IAWVu_{2 lim zu} LVu_{2 zi}\right) - dsum + fen \left(IAWfl_{1 lim zu} Lfl_{1 zi} + IAWfl_{2 lim zu} Lfl_{2 zi} + IAWfu_{1 lim zu} Lfu_{1 zi} + IAWfu_{2 lim zu} Lfu_{2 zi}\right)\) |
ue |
\(ue\) |
Algeb |
\(Ldsum_{zu} - ue\) |
f |
\(f\) |
ExtAlgeb |
\(0\) |
fin |
\(fin\) |
ExtAlgeb |
\(0\) |
fHzl |
\(fHzl\) |
ExtAlgeb |
\(- f fn ue\) |
Pext |
\(Pext\) |
ExtAlgeb |
\(0\) |
Pref |
\(Pref\) |
ExtAlgeb |
\(0\) |
Pdrp |
\(Pdrp\) |
ExtAlgeb |
\(0\) |
Psum |
\(Psum\) |
ExtAlgeb |
\(- ue \left(Pdrp + Pext + Pref\right)\) |
Qdrp |
\(Qdrp\) |
ExtAlgeb |
\(0\) |
Qref |
\(Qref\) |
ExtAlgeb |
\(0\) |
Qsum |
\(Qsum\) |
ExtAlgeb |
\(- ue \left(Qdrp + Qref\right)\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ltu |
\(ltu\) |
\(0.8\) |
ConstService |
ltl |
\(ltl\) |
\(0.2\) |
ConstService |
zero |
\(zero\) |
\(0\) |
ConstService |
res |
\(res\) |
\(0\) |
ExtendedEvent |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
Ldsum |
\(Ldsum\) |
Limiter |
lock signal comparer, zu is to act |
Lfl1 |
\(Lfl1\) |
Limiter |
Frequency comparer for (fl3, fl1) |
Lfl2 |
\(Lfl2\) |
Limiter |
Frequency comparer for (fl3, fl2) |
Lfu1 |
\(Lfu1\) |
Limiter |
Frequency comparer for (fu1, fu3) |
Lfu2 |
\(Lfu2\) |
Limiter |
Frequency comparer for (fu2, fu3) |
IAWfl1_lim |
\(lim_{IAWfl1}\) |
AntiWindup |
Limiter in integrator |
IAWfl2_lim |
\(lim_{IAWfl2}\) |
AntiWindup |
Limiter in integrator |
IAWfu1_lim |
\(lim_{IAWfu1}\) |
AntiWindup |
Limiter in integrator |
IAWfu2_lim |
\(lim_{IAWfu2}\) |
AntiWindup |
Limiter in integrator |
LVl1 |
\(LVl1\) |
Limiter |
Voltage comparer for (vl4, vl1) |
LVl2 |
\(LVl2\) |
Limiter |
Voltage comparer for (vl4, vl2) |
LVl3 |
\(LVl3\) |
Limiter |
Voltage comparer for (vl4, vl3) |
LVu1 |
\(LVu1\) |
Limiter |
Voltage comparer for (vu1, vu3) |
LVu2 |
\(LVu2\) |
Limiter |
Voltage comparer for (vu2, vu3) |
IAWVl1_lim |
\(lim_{IAWVl1}\) |
AntiWindup |
Limiter in integrator |
IAWVl2_lim |
\(lim_{IAWVl2}\) |
AntiWindup |
Limiter in integrator |
IAWVl3_lim |
\(lim_{IAWVl3}\) |
AntiWindup |
Limiter in integrator |
IAWVu1_lim |
\(lim_{IAWVu1}\) |
AntiWindup |
Limiter in integrator |
IAWVu2_lim |
\(lim_{IAWVu2}\) |
AntiWindup |
Limiter in integrator |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
IAWfl1 |
\(IAWfl1\) |
IntegratorAntiWindup |
condition check for (fl3, fl1) |
IAWfl2 |
\(IAWfl2\) |
IntegratorAntiWindup |
condition check for (fl3, fl2) |
IAWfu1 |
\(IAWfu1\) |
IntegratorAntiWindup |
condition check for (fu1, fu3) |
IAWfu2 |
\(IAWfu2\) |
IntegratorAntiWindup |
condition check for (fu2, fu3) |
IAWVl1 |
\(IAWVl1\) |
IntegratorAntiWindup |
condition check for (Vl3, Vl1) |
IAWVl2 |
\(IAWVl2\) |
IntegratorAntiWindup |
condition check for (Vl3, Vl2) |
IAWVl3 |
\(IAWVl3\) |
IntegratorAntiWindup |
condition check for (Vl3, Vl2) |
IAWVu1 |
\(IAWVu1\) |
IntegratorAntiWindup |
condition check for (Vu1, Vu3) |
IAWVu2 |
\(IAWVu2\) |
IntegratorAntiWindup |
condition check for (Vu2, Vu3) |
Config Fields in [DGPRCTExt]
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) |