RenTorque#
Renewable torque (Pref) controller.
Common Parameters: u, name
Available models: WTTQA1
WTTQA1#
Wind turbine generator torque (Pref) model.
PI state freeze following voltage dip has not been implemented.
Resets wg in REECA1 model to 1.0 when torque model is connected. This effectively ignores PFLAG of REECA1.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
rep |
RenPitch controller idx |
mandatory |
|||
Kip |
\(K_{ip}\) |
Pref-control integral gain |
0.100 |
p.u. |
|
Kpp |
\(K_{pp}\) |
Pref-control proportional gain |
0 |
p.u. |
|
Tp |
\(T_p\) |
Pe sensing time const. |
0.050 |
s |
|
Twref |
\(T_{wref}\) |
Speed reference time const. |
30 |
s |
|
Temax |
\(T_{emax}\) |
Max. electric torque |
1.200 |
p.u. |
power |
Temin |
\(T_{emin}\) |
Min. electric torque |
0 |
p.u. |
power |
Tflag |
Tflag; 1-power error, 0-speed error |
bool |
mandatory |
||
p1 |
\(p_1\) |
Active power point 1 |
0.200 |
p.u. |
power |
sp1 |
\(s_{p1}\) |
Speed power point 1 |
0.580 |
p.u. |
|
p2 |
\(p_2\) |
Active power point 2 |
0.400 |
p.u. |
power |
sp2 |
\(s_{p2}\) |
Speed power point 2 |
0.720 |
p.u. |
|
p3 |
\(p_3\) |
Active power point 3 |
0.600 |
p.u. |
power |
sp3 |
\(s_{p3}\) |
Speed power point 3 |
0.860 |
p.u. |
|
p4 |
\(p_4\) |
Active power point 4 |
0.800 |
p.u. |
power |
sp4 |
\(s_{p4}\) |
Speed power point 4 |
1 |
p.u. |
|
Tn |
\(T_n\) |
Turbine rating. Use Sn from gov if none. |
nan |
MVA |
|
rea |
0 |
||||
rego |
0 |
||||
ree |
0 |
||||
reg |
0 |
||||
Sngo |
\(S_{n,go}\) |
0 |
|||
w0 |
\(\omega_0\) |
0 |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
---|---|---|---|---|---|
s1_y |
\(y_{s_1}\) |
State |
State in lag transfer function |
v_str |
|
s2_y |
\(y_{s_2}\) |
State |
State in lag transfer function |
v_str |
|
PI_xi |
\(xi_{PI}\) |
State |
Integrator output |
v_str |
|
wg |
\(\omega_{g}\) |
ExtState |
v_str,v_setter |
||
wt |
\(\omega_{t}\) |
ExtState |
v_str,v_setter |
||
s3_y |
\(y_{s3}\) |
ExtState |
v_str,v_setter |
||
fPe_y |
\(y_{f_{Pe}}\) |
Algeb |
Output of piecewise |
v_str |
|
Tsel |
\(T_{sel}\) |
Algeb |
Output after Tflag selector |
v_str |
|
PI_yul |
\(y^{ul}_{PI}\) |
Algeb |
v_str |
||
PI_y |
\(y_{PI}\) |
Algeb |
PI output |
v_str |
|
Pe |
\(P_{e}\) |
ExtAlgeb |
|||
wr0 |
\(\omega_{r0}\) |
ExtAlgeb |
Retrieved initial w0 from RenGovernor |
v_str,v_setter |
|
wge |
\(\omega_{ge}\) |
ExtAlgeb |
v_str,v_setter |
||
Pref |
\(P_{ref}\) |
ExtAlgeb |
v_str,v_setter |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
---|---|---|---|
s1_y |
\(y_{s_1}\) |
State |
\(1.0 P_{e}\) |
s2_y |
\(y_{s_2}\) |
State |
\(1.0 y_{f_{Pe}}\) |
PI_xi |
\(xi_{PI}\) |
State |
\(\frac{P_{ref0}}{y_{f_{Pe}}}\) |
wg |
\(\omega_{g}\) |
ExtState |
\(y_{f_{Pe}}\) |
wt |
\(\omega_{t}\) |
ExtState |
\(y_{f_{Pe}}\) |
s3_y |
\(y_{s3}\) |
ExtState |
\(\frac{P_{ref0}}{\omega_{g}}\) |
fPe_y |
\(y_{f_{Pe}}\) |
Algeb |
\(\operatorname{FixPiecewise}{\left(\left( s_{p1}, \ p_{1} \geq y_{s_1}\right),\left( k_{p1} \left(- p_{1} + y_{s_1}\right) + s_{p1}, \ p_{2} \geq y_{s_1}\right),\left( k_{p2} \left(- p_{2} + y_{s_1}\right) + s_{p2}, \ p_{3} \geq y_{s_1}\right),\left( k_{p3} \left(- p_{3} + y_{s_1}\right) + s_{p3}, \ p_{4} \geq y_{s_1}\right),\left( s_{p4}, \ \text{True}\right) \right)}\) |
Tsel |
\(T_{sel}\) |
Algeb |
\(SWT_{s0} \left(- \omega_{g} + y_{s_2}\right) + \frac{SWT_{s1} \left(P_{e} - P_{ref0}\right)}{\omega_{g}}\) |
PI_yul |
\(y^{ul}_{PI}\) |
Algeb |
\(K_{pp} T_{sel} + \frac{P_{ref0}}{y_{f_{Pe}}}\) |
PI_y |
\(y_{PI}\) |
Algeb |
\(\pi_{hl zi} y^{ul}_{PI} + \pi_{hl zl} T_{emin} + \pi_{hl zu} T_{emax}\) |
Pe |
\(P_{e}\) |
ExtAlgeb |
|
wr0 |
\(\omega_{r0}\) |
ExtAlgeb |
\(y_{f_{Pe}}\) |
wge |
\(\omega_{ge}\) |
ExtAlgeb |
\(1.0\) |
Pref |
\(P_{ref}\) |
ExtAlgeb |
\(\omega_{g} y_{PI}\) |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
---|---|---|---|---|
s1_y |
\(y_{s_1}\) |
State |
\(1.0 P_{e} - y_{s_1}\) |
\(T_p\) |
s2_y |
\(y_{s_2}\) |
State |
\(1.0 y_{f_{Pe}} - y_{s_2}\) |
\(T_{wref}\) |
PI_xi |
\(xi_{PI}\) |
State |
\(K_{ip} T_{sel}\) |
|
wg |
\(\omega_{g}\) |
ExtState |
\(0\) |
|
wt |
\(\omega_{t}\) |
ExtState |
\(0\) |
|
s3_y |
\(y_{s3}\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
---|---|---|---|
fPe_y |
\(y_{f_{Pe}}\) |
Algeb |
\(- y_{f_{Pe}} + \operatorname{FixPiecewise}{\left(\left( s_{p1}, \ p_{1} \geq y_{s_1}\right),\left( k_{p1} \left(- p_{1} + y_{s_1}\right) + s_{p1}, \ p_{2} \geq y_{s_1}\right),\left( k_{p2} \left(- p_{2} + y_{s_1}\right) + s_{p2}, \ p_{3} \geq y_{s_1}\right),\left( k_{p3} \left(- p_{3} + y_{s_1}\right) + s_{p3}, \ p_{4} \geq y_{s_1}\right),\left( s_{p4}, \ \text{True}\right) \right)}\) |
Tsel |
\(T_{sel}\) |
Algeb |
\(SWT_{s0} \left(- \omega_{g} + y_{s_2}\right) + \frac{SWT_{s1} \left(P_{e} - P_{ref0}\right)}{\omega_{g}} - T_{sel}\) |
PI_yul |
\(y^{ul}_{PI}\) |
Algeb |
\(K_{pp} T_{sel} + xi_{PI} - y^{ul}_{PI}\) |
PI_y |
\(y_{PI}\) |
Algeb |
\(\pi_{hl zi} y^{ul}_{PI} + \pi_{hl zl} T_{emin} + \pi_{hl zu} T_{emax} - y_{PI}\) |
Pe |
\(P_{e}\) |
ExtAlgeb |
\(0\) |
wr0 |
\(\omega_{r0}\) |
ExtAlgeb |
\(- \omega_{0} + y_{f_{Pe}}\) |
wge |
\(\omega_{ge}\) |
ExtAlgeb |
\(1 - y_{f_{Pe}}\) |
Pref |
\(P_{ref}\) |
ExtAlgeb |
\(- \frac{P_{ref0}}{\omega_{ge}} + \omega_{g} y_{PI}\) |
Services#
Name |
Symbol |
Equation |
Type |
---|---|---|---|
kp1 |
\(k_{p1}\) |
\(\frac{- s_{p1} + s_{p2}}{- p_{1} + p_{2}}\) |
ConstService |
kp2 |
\(k_{p2}\) |
\(\frac{- s_{p2} + s_{p3}}{- p_{2} + p_{3}}\) |
ConstService |
kp3 |
\(k_{p3}\) |
\(\frac{- s_{p3} + s_{p4}}{- p_{3} + p_{4}}\) |
ConstService |
Discretes#
Name |
Symbol |
Type |
Info |
---|---|---|---|
SWT |
\(SW_{T}\) |
Switcher |
|
PI_aw |
\(aw_{PI}\) |
AntiWindup |
|
PI_hl |
\(hl_{PI}\) |
HardLimiter |
Blocks#
Name |
Symbol |
Type |
Info |
---|---|---|---|
s1 |
\(s_1\) |
Lag |
Pe filter |
fPe |
\(f_{Pe}\) |
Piecewise |
Piecewise Pe to wref mapping |
s2 |
\(s_2\) |
Lag |
speed filter |
PI |
\(PI\) |
PIAWHardLimit |
PI controller |
Config Fields in [WTTQA1]
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) |