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)