RenPitch#
Renewable generator pitch controller group.
Common Parameters: u, name, rea
Available models: WTPTA1
WTPTA1#
Wind turbine pitch control model.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
rea |
Renewable aerodynamics model idx |
mandatory |
|||
Kiw |
\(K_{iw}\) |
Pitch-control integral gain |
0.100 |
p.u. |
|
Kpw |
\(K_{pw}\) |
Pitch-control proportional gain |
0 |
p.u. |
|
Kic |
\(K_{ic}\) |
Pitch-compensation integral gain |
0.100 |
p.u. |
|
Kpc |
\(K_{pc}\) |
Pitch-compensation proportional gain |
0 |
p.u. |
|
Kcc |
\(K_{cc}\) |
Gain for P diff |
0 |
p.u. |
|
Tp |
\(T_{\theta}\) |
Blade response time const. |
0.300 |
s |
|
thmax |
\(\theta_{max}\) |
Max. pitch angle |
30 |
deg. |
|
thmin |
\(\theta_{min}\) |
Min. pitch angle |
0 |
deg. |
|
dthmax |
\(\theta_{max}\) |
Max. pitch angle rate |
5 |
deg. |
|
dthmin |
\(\theta_{min}\) |
Min. pitch angle rate |
-5 |
deg. |
|
rego |
0 |
||||
ree |
0 |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
---|---|---|---|---|---|
PIc_xi |
\(xi_{PI_c}\) |
State |
Integrator output |
v_str |
|
PIw_xi |
\(xi_{PI_w}\) |
State |
Integrator output |
v_str |
|
LG_y |
\(y_{LG}\) |
State |
State in lag TF |
v_str |
|
wt |
\(wt\) |
ExtState |
|||
Pord |
\(Pord\) |
ExtState |
|||
PIc_yul |
\(y^{ul}_{PI_c}\) |
Algeb |
v_str |
||
PIc_y |
\(y_{PI_c}\) |
Algeb |
PI output |
v_str |
|
wref |
\(\omega_{ref}\) |
Algeb |
optional speed reference |
v_str |
|
PIw_yul |
\(y^{ul}_{PI_w}\) |
Algeb |
v_str |
||
PIw_y |
\(y_{PI_w}\) |
Algeb |
PI output |
v_str |
|
theta |
\(\theta\) |
ExtAlgeb |
|||
Pref |
\(Pref\) |
ExtAlgeb |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
---|---|---|---|
PIc_xi |
\(xi_{PI_c}\) |
State |
\(0.0\) |
PIw_xi |
\(xi_{PI_w}\) |
State |
\(0.0\) |
LG_y |
\(y_{LG}\) |
State |
\(1.0 y_{PI_c} + 1.0 y_{PI_w}\) |
wt |
\(wt\) |
ExtState |
|
Pord |
\(Pord\) |
ExtState |
|
PIc_yul |
\(y^{ul}_{PI_c}\) |
Algeb |
\(K_{pc} \left(Pord - Pref\right)\) |
PIc_y |
\(y_{PI_c}\) |
Algeb |
\(PIc_{hl zi} y^{ul}_{PI_c} + PIc_{hl zl} \theta_{min} + PIc_{hl zu} \theta_{max}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(wt\) |
PIw_yul |
\(y^{ul}_{PI_w}\) |
Algeb |
\(K_{pw} \left(K_{cc} \left(Pord - Pref\right) - \omega_{ref} + wt\right)\) |
PIw_y |
\(y_{PI_w}\) |
Algeb |
\(PIw_{hl zi} y^{ul}_{PI_w} + PIw_{hl zl} \theta_{min} + PIw_{hl zu} \theta_{max}\) |
theta |
\(\theta\) |
ExtAlgeb |
|
Pref |
\(Pref\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
---|---|---|---|---|
PIc_xi |
\(xi_{PI_c}\) |
State |
\(K_{ic} \left(Pord - Pref\right)\) |
|
PIw_xi |
\(xi_{PI_w}\) |
State |
\(K_{iw} \left(K_{cc} \left(Pord - Pref\right) - \omega_{ref} + wt\right)\) |
|
LG_y |
\(y_{LG}\) |
State |
\(- y_{LG} + 1.0 y_{PI_c} + 1.0 y_{PI_w}\) |
\(T_{\theta}\) |
wt |
\(wt\) |
ExtState |
\(0\) |
|
Pord |
\(Pord\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
---|---|---|---|
PIc_yul |
\(y^{ul}_{PI_c}\) |
Algeb |
\(K_{pc} \left(Pord - Pref\right) + xi_{PI_c} - y^{ul}_{PI_c}\) |
PIc_y |
\(y_{PI_c}\) |
Algeb |
\(PIc_{hl zi} y^{ul}_{PI_c} + PIc_{hl zl} \theta_{min} + PIc_{hl zu} \theta_{max} - y_{PI_c}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(- \omega_{ref} + wref_{0}\) |
PIw_yul |
\(y^{ul}_{PI_w}\) |
Algeb |
\(K_{pw} \left(K_{cc} \left(Pord - Pref\right) - \omega_{ref} + wt\right) + xi_{PI_w} - y^{ul}_{PI_w}\) |
PIw_y |
\(y_{PI_w}\) |
Algeb |
\(PIw_{hl zi} y^{ul}_{PI_w} + PIw_{hl zl} \theta_{min} + PIw_{hl zu} \theta_{max} - y_{PI_w}\) |
theta |
\(\theta\) |
ExtAlgeb |
\(- \theta_{0} + y_{LG}\) |
Pref |
\(Pref\) |
ExtAlgeb |
\(0\) |
Services#
Name |
Symbol |
Equation |
Type |
---|---|---|---|
wref0 |
\(wref0\) |
\(\omega_{ref}\) |
PostInitService |
Discretes#
Name |
Symbol |
Type |
Info |
---|---|---|---|
PIc_aw |
\(aw_{PI_c}\) |
AntiWindup |
|
PIc_hl |
\(hl_{PI_c}\) |
HardLimiter |
|
PIw_aw |
\(aw_{PI_w}\) |
AntiWindup |
|
PIw_hl |
\(hl_{PI_w}\) |
HardLimiter |
|
LG_lim |
\(lim_{LG}\) |
AntiWindupRate |
Limiter in Lag |
Blocks#
Name |
Symbol |
Type |
Info |
---|---|---|---|
PIc |
\(PI_c\) |
PIAWHardLimit |
PI for active power diff compensation |
PIw |
\(PI_w\) |
PIAWHardLimit |
PI for speed and active power deviation |
LG |
\(LG\) |
LagAntiWindupRate |
Output lag anti-windup rate limiter |
Config Fields in [WTPTA1]
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) |