RenGovernor#

Renewable turbine governor group.

Common Parameters: u, name, ree, w0, Sn, Pe0

Common Variables: Pm, wr0, wt, wg, s3_y

Available models: WTDTA1, WTDS

WTDTA1#

WTDTA wind turbine drive-train model.

One can set Htfrac to 0 to simulate a single-mass drive train. Htfrac has to be within [0, 1]

User-provided reference speed should be specified in parameter w0. Internally, w0 is set to the algebraic variable wr0.

Note for PSS/E dyr parser:

In PSS/E doc, Freq1 is said to be Hz, but exported data from PSS/E 34 uses per unit. ANDES requires Freq1 in per unit frequency.

Parameters#

Name	Symbol	Description	Default	Unit	Properties
idx		unique device idx
u	\(u\)	connection status	1	bool
name		device name
ree		Renewable exciter idx			mandatory
H	\(H_t\)	Total inertia constant	3	MWs/MVA	non_zero,non_negative,power
DAMP	\(Damp\)	Damp coefficient	0	p.u. (gen base)	power
Htfrac	\(D_{shaft}\)	Turbine inertia fraction (Hturb/H)	0.500		power
Freq1	\(Freq1\)	First shaft torsional resonant frequency, p.u. (Hz)	1	p.u. (Hz)
Dshaft	\(D_{shaft}\)	Shaft damping factor	1	p.u. (gen base)	power
w0	\(\omega_0\)	Default speed if not using a torque model	1	p.u.
reg			0
Sn	\(S_n\)		0

Variables#

Name	Symbol	Type	Description	Unit	Properties
s1_y	\(s_{1 y}\)	State	Integrator output		v_str
s2_y	\(s_{2 y}\)	State	Integrator output		v_str
s3_y	\(s_{3 y}\)	State	Integrator output		v_str
wt	\(wt\)	AliasState	Alias of s1_y
wg	\(wg\)	AliasState	Alias of s2_y
wr0	\(wr_{0}\)	Algeb	speed set point	p.u.	v_str
Pm	\(Pm\)	Algeb	Mechanical power		v_str
pd	\(pd\)	Algeb	Output after damping		v_str
wge	\(wge\)	ExtAlgeb
Pe	\(Pe\)	ExtAlgeb	Retrieved Pe of RenGen

Initialization Equations#

Name	Symbol	Type	Initial Value
s1_y	\(s_{1 y}\)	State	\(wr_{0}\)
s2_y	\(s_{2 y}\)	State	\(wr_{0}\)
s3_y	\(s_{3 y}\)	State	\(\frac{Pe_{0}}{wr_{0}}\)
wt	\(wt\)	AliasState
wg	\(wg\)	AliasState
wr0	\(wr_{0}\)	Algeb	\(w_{0}\)
Pm	\(Pm\)	Algeb	\(Pe_{0}\)
pd	\(pd\)	Algeb	\(0\)
wge	\(wge\)	ExtAlgeb
Pe	\(Pe\)	ExtAlgeb

Differential Equations#

Name	Symbol	Type	RHS of Equation "T x' = f(x, y)"	T (LHS)
s1_y	\(s_{1 y}\)	State	\(\frac{1.0 Pm}{s_{1 y}} - 1.0 pd - 1.0 s_{3 y}\)	\(2H_t\)
s2_y	\(s_{2 y}\)	State	\(- 1.0 DAMP \left(s_{2 y} - w_{0}\right) - \frac{1.0 Pe}{s_{2 y}} + 1.0 pd + 1.0 s_{3 y}\)	\(2H_g\)
s3_y	\(s_{3 y}\)	State	\(Kshaft \left(s_{1 y} - s_{2 y}\right)\)	\(1.0\)
wt	\(wt\)	AliasState	\(0\)
wg	\(wg\)	AliasState	\(0\)

Algebraic Equations#

Name	Symbol	Type	RHS of Equation "0 = g(x, y)"
wr0	\(wr_{0}\)	Algeb	\(w_{0} - wr_{0}\)
Pm	\(Pm\)	Algeb	\(Pe_{0} - Pm\)
pd	\(pd\)	Algeb	\(Dshaft \left(s_{1 y} - s_{2 y}\right) - pd\)
wge	\(wge\)	ExtAlgeb	\(s_{2 y} - 1.0\)
Pe	\(Pe\)	ExtAlgeb	\(0\)

Services#

Name	Symbol	Equation	Type
Ht2	\(2H_t\)	\(2 H Htfrac\)	ConstService
Hg2	\(2H_g\)	\(2 H \left(1 - Htfrac\right)\)	ConstService
Kshaft	\(K_{shaft}\)	\(\frac{0.5 Freq_{1}^{2} Hg_{2} Ht_{2}}{H}\)	ConstService

Blocks#

Name	Symbol	Type
s1	\(s1\)	Integrator
s2	\(s2\)	Integrator
s3	\(s3\)	Integrator

Config Fields in [WTDTA1]

Option	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)

WTDS#

Custom wind turbine model with a single swing-equation.

This model is used to simulate the mechanical swing of the combined machine and turbine mass. The speed output is s1_y which will be fed to RenExciter.wg.

PFLAG needs to be set to 1 in exciter to consider speed for Pref.