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 |
\(PIc_{\xi}\) |
State |
Integrator output |
v_str |
|
PIw_xi |
\(PIw_{\xi}\) |
State |
Integrator output |
v_str |
|
LG_y |
\(LG_{y}\) |
State |
State in lag TF |
v_str |
|
wt |
\(wt\) |
ExtState |
|||
Pord |
\(Pord\) |
ExtState |
|||
PIc_yul |
\(PIc_{yul}\) |
Algeb |
v_str |
||
PIc_y |
\(PIc_{y}\) |
Algeb |
PI output |
v_str |
|
wref |
\(wref\) |
Algeb |
optional speed reference |
v_str |
|
PIw_yul |
\(PIw_{yul}\) |
Algeb |
v_str |
||
PIw_y |
\(PIw_{y}\) |
Algeb |
PI output |
v_str |
|
theta |
\(\theta\) |
ExtAlgeb |
|||
Pref |
\(Pref\) |
ExtAlgeb |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
PIc_xi |
\(PIc_{\xi}\) |
State |
\(0.0\) |
PIw_xi |
\(PIw_{\xi}\) |
State |
\(0.0\) |
LG_y |
\(LG_{y}\) |
State |
\(1.0 PIc_{y} + 1.0 PIw_{y}\) |
wt |
\(wt\) |
ExtState |
|
Pord |
\(Pord\) |
ExtState |
|
PIc_yul |
\(PIc_{yul}\) |
Algeb |
\(Kpc \left(Pord - Pref\right)\) |
PIc_y |
\(PIc_{y}\) |
Algeb |
\(PIc_{hl zi} PIc_{yul} + PIc_{hl zl} thmin + PIc_{hl zu} thmax\) |
wref |
\(wref\) |
Algeb |
\(wt\) |
PIw_yul |
\(PIw_{yul}\) |
Algeb |
\(Kpw \left(Kcc \left(Pord - Pref\right) - wref + wt\right)\) |
PIw_y |
\(PIw_{y}\) |
Algeb |
\(PIw_{hl zi} PIw_{yul} + PIw_{hl zl} thmin + PIw_{hl zu} thmax\) |
theta |
\(\theta\) |
ExtAlgeb |
|
Pref |
\(Pref\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
PIc_xi |
\(PIc_{\xi}\) |
State |
\(Kic \left(Pord - Pref\right)\) |
|
PIw_xi |
\(PIw_{\xi}\) |
State |
\(Kiw \left(Kcc \left(Pord - Pref\right) - wref + wt\right)\) |
|
LG_y |
\(LG_{y}\) |
State |
\(- LG_{y} + 1.0 PIc_{y} + 1.0 PIw_{y}\) |
\(T_{\theta}\) |
wt |
\(wt\) |
ExtState |
\(0\) |
|
Pord |
\(Pord\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
PIc_yul |
\(PIc_{yul}\) |
Algeb |
\(Kpc \left(Pord - Pref\right) + PIc_{\xi} - PIc_{yul}\) |
PIc_y |
\(PIc_{y}\) |
Algeb |
\(PIc_{hl zi} PIc_{yul} + PIc_{hl zl} thmin + PIc_{hl zu} thmax - PIc_{y}\) |
wref |
\(wref\) |
Algeb |
\(- wref + wref_{0}\) |
PIw_yul |
\(PIw_{yul}\) |
Algeb |
\(Kpw \left(Kcc \left(Pord - Pref\right) - wref + wt\right) + PIw_{\xi} - PIw_{yul}\) |
PIw_y |
\(PIw_{y}\) |
Algeb |
\(PIw_{hl zi} PIw_{yul} + PIw_{hl zl} thmin + PIw_{hl zu} thmax - PIw_{y}\) |
theta |
\(\theta\) |
ExtAlgeb |
\(LG_{y} - \theta_{0}\) |
Pref |
\(Pref\) |
ExtAlgeb |
\(0\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
wref0 |
\(wref0\) |
\(wref\) |
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) |