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)