TurbineGov#
Turbine governor group for synchronous generator.
Common Parameters: u, name
Common Variables: pout
Available models: TG2, TGOV1, TGOV1DB, TGOV1N, TGOV1NDB, IEEEG1, IEESGO, GAST, HYGOV, HYGOVDB, HYGOV4
TG2#
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
syn |
Synchronous generator idx |
mandatory,unique |
|||
Tn |
\(T_n\) |
Turbine power rating. Equal to Sn if not provided. |
0 |
MVA |
|
wref0 |
\(\omega_{ref0}\) |
Base speed reference |
1 |
p.u. |
|
R |
\(R\) |
Speed regulation gain (mach. base default) |
0.050 |
p.u. |
ipower |
pmax |
\(p_{max}\) |
Maximum power output |
999 |
p.u. |
power |
pmin |
\(p_{min}\) |
Minimum power output |
0 |
p.u. |
power |
dbl |
\(L_{db}\) |
Deadband lower limit |
-0.000 |
p.u. |
|
dbu |
\(U_{db}\) |
Deadband upper limit |
0.000 |
p.u. |
|
dbc |
\(C_{db}\) |
Deadband neutral value |
0 |
p.u. |
|
T1 |
\(T_1\) |
Transient gain time |
0.200 |
||
T2 |
\(T_2\) |
Governor time constant |
10 |
||
Sg |
\(S_n\) |
Rated power from generator |
0 |
MVA |
|
ug |
\(u_g\) |
Generator connection status |
0 |
bool |
|
Vn |
\(V_n\) |
Rated voltage from generator |
0 |
kV |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
ll_x |
\(x'_{ll}\) |
State |
State in lead-lag |
v_str |
|
omega |
\(\omega\) |
ExtState |
Generator speed |
p.u. |
|
paux |
\(P_{aux}\) |
Algeb |
Auxiliary power input |
v_str |
|
pout |
\(P_{out}\) |
Algeb |
Turbine final output power |
v_str |
|
wref |
\(\omega_{ref}\) |
Algeb |
Speed reference variable |
v_str |
|
w_d |
\(\omega_{dev}\) |
Algeb |
Generator speed deviation before dead band (positive for under speed) |
v_str |
|
w_dm |
\(\omega_{dm}\) |
Algeb |
Measured speed deviation after dead band |
v_str |
|
w_dmg |
\(\omega_{dmG}\) |
Algeb |
Speed deviation after dead band after gain |
v_str |
|
ll_y |
\(y_{ll}\) |
Algeb |
Output of lead-lag |
v_str |
|
pnl |
\(P_{nl}\) |
Algeb |
Power output before hard limiter |
v_str |
|
tm |
\(\tau_{m}\) |
ExtAlgeb |
Mechanical power interface to SynGen |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
ll_x |
\(x'_{ll}\) |
State |
\(\omega_{dmG}\) |
omega |
\(\omega\) |
ExtState |
|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0}\) |
pout |
\(P_{out}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0}\) |
w_d |
\(\omega_{dev}\) |
Algeb |
\(0\) |
w_dm |
\(\omega_{dm}\) |
Algeb |
\(0\) |
w_dmg |
\(\omega_{dmG}\) |
Algeb |
\(0\) |
ll_y |
\(y_{ll}\) |
Algeb |
\(\omega_{dmG}\) |
pnl |
\(P_{nl}\) |
Algeb |
\(\tau_{m0}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
ll_x |
\(x'_{ll}\) |
State |
\(\omega_{dmG} - x'_{ll}\) |
\(T_2\) |
omega |
\(\omega\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0} - P_{aux}\) |
pout |
\(P_{out}\) |
Algeb |
\(P_{nl} z_{i}^{plim} - P_{out} + p_{max} z_{u}^{plim} + p_{min} z_{l}^{plim}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0} - \omega_{ref}\) |
w_d |
\(\omega_{dev}\) |
Algeb |
\(- \omega_{dev} + u_{e} \left(- \omega + \omega_{ref}\right)\) |
w_dm |
\(\omega_{dm}\) |
Algeb |
\(L_{db} z_{lr}^{w_{db}} + U_{db} z_{ur}^{w_{db}} + \omega_{dev} \left(1 - z_{i}^{w_{db}}\right) - \omega_{dm}\) |
w_dmg |
\(\omega_{dmG}\) |
Algeb |
\(G \omega_{dm} - \omega_{dmG}\) |
ll_y |
\(y_{ll}\) |
Algeb |
\(T_{1} \left(\omega_{dmG} - x'_{ll}\right) + T_{2} x'_{ll} - T_{2} y_{ll} + ll_{LT1 z1} ll_{LT2 z1} \left(- x'_{ll} + y_{ll}\right)\) |
pnl |
\(P_{nl}\) |
Algeb |
\(- P_{nl} + P_{ref0} + y_{ll}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
\(u_{e} \left(P_{out} - \tau_{m0}\right)\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ue |
\(u_{e}\) |
\(u u_{g}\) |
ConstService |
pref0 |
\(P_{ref0}\) |
\(\tau_{m0}\) |
ConstService |
paux0 |
\(P_{aux0}\) |
\(0\) |
ConstService |
gain |
\(G\) |
\(\frac{u}{R}\) |
ConstService |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
w_db |
\(w_db\) |
DeadBandRT |
|
ll_LT1 |
\(LT_{ll}\) |
LessThan |
|
ll_LT2 |
\(LT_{ll}\) |
LessThan |
|
plim |
\(plim\) |
HardLimiter |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
ll |
\(ll\) |
LeadLag |
Config Fields in [TG2]
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) |
|
deadband |
\(z_{deadband}\) |
0 |
enable input dead band |
(0, 1) |
hardlimit |
\(z_{hardlimit}\) |
1 |
enable output hard limit |
(0, 1) |
TGOV1#
TGOV1 turbine governor model.
Implements the PSS/E TGOV1 model without deadband.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
syn |
Synchronous generator idx |
mandatory,unique |
|||
Tn |
\(T_n\) |
Turbine power rating. Equal to Sn if not provided. |
0 |
MVA |
|
wref0 |
\(\omega_{ref0}\) |
Base speed reference |
1 |
p.u. |
|
R |
\(R\) |
Speed regulation gain (mach. base default) |
0.050 |
p.u. |
ipower |
VMAX |
\(V_{max}\) |
Maximum valve position |
1.200 |
p.u. |
power |
VMIN |
\(V_{min}\) |
Minimum valve position |
0 |
p.u. |
power |
T1 |
\(T_1\) |
Valve time constant |
0.100 |
||
T2 |
\(T_2\) |
Lead-lag lead time constant |
0.200 |
||
T3 |
\(T_3\) |
Lead-lag lag time constant |
10 |
||
Dt |
\(D_t\) |
Turbine damping coefficient |
0 |
power |
|
Sg |
\(S_n\) |
Rated power from generator |
0 |
MVA |
|
ug |
\(u_g\) |
Generator connection status |
0 |
bool |
|
Vn |
\(V_n\) |
Rated voltage from generator |
0 |
kV |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
State in lag TF |
v_str |
|
LL_x |
\(x'_{LL}\) |
State |
State in lead-lag |
v_str |
|
omega |
\(\omega\) |
ExtState |
Generator speed |
p.u. |
|
paux |
\(P_{aux}\) |
Algeb |
Auxiliary power input |
v_str |
|
pout |
\(P_{out}\) |
Algeb |
Turbine final output power |
v_str |
|
wref |
\(\omega_{ref}\) |
Algeb |
Speed reference variable |
v_str |
|
pref |
\(P_{ref}\) |
Algeb |
Reference power input |
v_str |
|
wd |
\(\omega_{dev}\) |
Algeb |
Generator speed deviation |
p.u. |
v_str |
pd |
\(P_{d}\) |
Algeb |
Pref plus speed deviation times gain |
p.u. |
v_str |
LL_y |
\(y_{LL}\) |
Algeb |
Output of lead-lag |
v_str |
|
tm |
\(\tau_{m}\) |
ExtAlgeb |
Mechanical power interface to SynGen |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
\(P_{d}\) |
LL_x |
\(x'_{LL}\) |
State |
\(y_{LAG}\) |
omega |
\(\omega\) |
ExtState |
|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0}\) |
pout |
\(P_{out}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0}\) |
pref |
\(P_{ref}\) |
Algeb |
\(R \tau_{m0}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(0\) |
pd |
\(P_{d}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
LL_y |
\(y_{LL}\) |
Algeb |
\(y_{LAG}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
\(P_{d} - y_{LAG}\) |
\(T_1\) |
LL_x |
\(x'_{LL}\) |
State |
\(- x'_{LL} + y_{LAG}\) |
\(T_3\) |
omega |
\(\omega\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0} - P_{aux}\) |
pout |
\(P_{out}\) |
Algeb |
\(- P_{out} + u_{e} \left(- D_{t} \omega_{dev} + y_{LL}\right)\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0} - \omega_{ref}\) |
pref |
\(P_{ref}\) |
Algeb |
\(P_{ref0} R - P_{ref}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(- \omega_{dev} + u_{e} \left(\omega - \omega_{ref}\right)\) |
pd |
\(P_{d}\) |
Algeb |
\(G u_{e} \left(P_{aux} + P_{ref} - \omega_{dev}\right) - P_{d}\) |
LL_y |
\(y_{LL}\) |
Algeb |
\(LL_{LT1 z1} LL_{LT2 z1} \left(- x'_{LL} + y_{LL}\right) + T_{2} \left(- x'_{LL} + y_{LAG}\right) + T_{3} x'_{LL} - T_{3} y_{LL}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
\(u_{e} \left(P_{out} - \tau_{m0}\right)\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ue |
\(u_{e}\) |
\(u u_{g}\) |
ConstService |
pref0 |
\(P_{ref0}\) |
\(\tau_{m0}\) |
ConstService |
paux0 |
\(P_{aux0}\) |
\(0\) |
ConstService |
gain |
\(G\) |
\(\frac{u_{e}}{R}\) |
ConstService |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LAG_lim |
\(lim_{LAG}\) |
AntiWindup |
Limiter in Lag |
LL_LT1 |
\(LT_{LL}\) |
LessThan |
|
LL_LT2 |
\(LT_{LL}\) |
LessThan |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LAG |
\(LAG\) |
LagAntiWindup |
|
LL |
\(LL\) |
LeadLag |
Config Fields in [TGOV1]
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) |
TGOV1DB#
TGOV1 turbine governor model with speed input deadband.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
syn |
Synchronous generator idx |
mandatory,unique |
|||
Tn |
\(T_n\) |
Turbine power rating. Equal to Sn if not provided. |
0 |
MVA |
|
wref0 |
\(\omega_{ref0}\) |
Base speed reference |
1 |
p.u. |
|
R |
\(R\) |
Speed regulation gain (mach. base default) |
0.050 |
p.u. |
ipower |
VMAX |
\(V_{max}\) |
Maximum valve position |
1.200 |
p.u. |
power |
VMIN |
\(V_{min}\) |
Minimum valve position |
0 |
p.u. |
power |
T1 |
\(T_1\) |
Valve time constant |
0.100 |
||
T2 |
\(T_2\) |
Lead-lag lead time constant |
0.200 |
||
T3 |
\(T_3\) |
Lead-lag lag time constant |
10 |
||
Dt |
\(D_t\) |
Turbine damping coefficient |
0 |
power |
|
dbL |
\(db_L\) |
Lower bound of deadband |
0 |
p.u. |
|
dbU |
\(db_U\) |
Upper bound of deadband |
0 |
p.u. |
|
Sg |
\(S_n\) |
Rated power from generator |
0 |
MVA |
|
ug |
\(u_g\) |
Generator connection status |
0 |
bool |
|
Vn |
\(V_n\) |
Rated voltage from generator |
0 |
kV |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
State in lag TF |
v_str |
|
LL_x |
\(x'_{LL}\) |
State |
State in lead-lag |
v_str |
|
omega |
\(\omega\) |
ExtState |
Generator speed |
p.u. |
|
paux |
\(P_{aux}\) |
Algeb |
Auxiliary power input |
v_str |
|
pout |
\(P_{out}\) |
Algeb |
Turbine final output power |
v_str |
|
wref |
\(\omega_{ref}\) |
Algeb |
Speed reference variable |
v_str |
|
pref |
\(P_{ref}\) |
Algeb |
Reference power input |
v_str |
|
wd |
\(\omega_{dev}\) |
Algeb |
Generator speed deviation |
p.u. |
v_str |
pd |
\(P_{d}\) |
Algeb |
Pref plus speed deviation times gain |
p.u. |
v_str |
LL_y |
\(y_{LL}\) |
Algeb |
Output of lead-lag |
v_str |
|
DB_y |
\(y_{DB}\) |
Algeb |
Deadband type 1 output |
v_str |
|
tm |
\(\tau_{m}\) |
ExtAlgeb |
Mechanical power interface to SynGen |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
\(P_{d}\) |
LL_x |
\(x'_{LL}\) |
State |
\(y_{LAG}\) |
omega |
\(\omega\) |
ExtState |
|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0}\) |
pout |
\(P_{out}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0}\) |
pref |
\(P_{ref}\) |
Algeb |
\(R \tau_{m0}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(0\) |
pd |
\(P_{d}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
LL_y |
\(y_{LL}\) |
Algeb |
\(y_{LAG}\) |
DB_y |
\(y_{DB}\) |
Algeb |
\(1.0 DB_{db zl} \left(\omega_{dev} - db_{L}\right) + 1.0 DB_{db zu} \left(\omega_{dev} - db_{U}\right)\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
\(P_{d} - y_{LAG}\) |
\(T_1\) |
LL_x |
\(x'_{LL}\) |
State |
\(- x'_{LL} + y_{LAG}\) |
\(T_3\) |
omega |
\(\omega\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0} - P_{aux}\) |
pout |
\(P_{out}\) |
Algeb |
\(- D_{t} y_{DB} - P_{out} + y_{LL}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0} - \omega_{ref}\) |
pref |
\(P_{ref}\) |
Algeb |
\(P_{ref0} R - P_{ref}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(- \omega_{dev} + u_{e} \left(\omega - \omega_{ref}\right)\) |
pd |
\(P_{d}\) |
Algeb |
\(G u_{e} \left(P_{aux} + P_{ref} - y_{DB}\right) - P_{d}\) |
LL_y |
\(y_{LL}\) |
Algeb |
\(LL_{LT1 z1} LL_{LT2 z1} \left(- x'_{LL} + y_{LL}\right) + T_{2} \left(- x'_{LL} + y_{LAG}\right) + T_{3} x'_{LL} - T_{3} y_{LL}\) |
DB_y |
\(y_{DB}\) |
Algeb |
\(1.0 DB_{db zl} \left(\omega_{dev} - db_{L}\right) + 1.0 DB_{db zu} \left(\omega_{dev} - db_{U}\right) - y_{DB}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
\(u_{e} \left(P_{out} - \tau_{m0}\right)\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ue |
\(u_{e}\) |
\(u u_{g}\) |
ConstService |
pref0 |
\(P_{ref0}\) |
\(\tau_{m0}\) |
ConstService |
paux0 |
\(P_{aux0}\) |
\(0\) |
ConstService |
gain |
\(G\) |
\(\frac{u_{e}}{R}\) |
ConstService |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LAG_lim |
\(lim_{LAG}\) |
AntiWindup |
Limiter in Lag |
LL_LT1 |
\(LT_{LL}\) |
LessThan |
|
LL_LT2 |
\(LT_{LL}\) |
LessThan |
|
DB_db |
\(db_{DB}\) |
DeadBand |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LAG |
\(LAG\) |
LagAntiWindup |
|
LL |
\(LL\) |
LeadLag |
|
DB |
\(DB\) |
DeadBand1 |
deadband for speed deviation |
Config Fields in [TGOV1DB]
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) |
TGOV1N#
New TGOV1 (TGOV1N) turbine governor model.
The TGOV1N model that sums pref and paux signals after the droop.
This model is useful for incorporating AGC and scheduling signals, which
will not be multiplied by 1/R like in the original TGOV1 model.
Scheduling changes should write to pref0.v in place. AGC signal should
write to paux0.v in place.
Modifying tm0 is not allowed.
Examples#
To update all paux0 values to paux_new, which contains the new
values, do
ss.TGOV1N.paux0.v[:] = paux_new # in-place update of the `paux0.v` array
instead of
ss.TGOV1N.paux0.v = paux_new # error; changes the reference of `paux0.v`
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
syn |
Synchronous generator idx |
mandatory,unique |
|||
Tn |
\(T_n\) |
Turbine power rating. Equal to Sn if not provided. |
0 |
MVA |
|
wref0 |
\(\omega_{ref0}\) |
Base speed reference |
1 |
p.u. |
|
R |
\(R\) |
Speed regulation gain (mach. base default) |
0.050 |
p.u. |
ipower |
VMAX |
\(V_{max}\) |
Maximum valve position |
1.200 |
p.u. |
power |
VMIN |
\(V_{min}\) |
Minimum valve position |
0 |
p.u. |
power |
T1 |
\(T_1\) |
Valve time constant |
0.100 |
||
T2 |
\(T_2\) |
Lead-lag lead time constant |
0.200 |
||
T3 |
\(T_3\) |
Lead-lag lag time constant |
10 |
||
Dt |
\(D_t\) |
Turbine damping coefficient |
0 |
power |
|
Sg |
\(S_n\) |
Rated power from generator |
0 |
MVA |
|
ug |
\(u_g\) |
Generator connection status |
0 |
bool |
|
Vn |
\(V_n\) |
Rated voltage from generator |
0 |
kV |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
State in lag TF |
v_str |
|
LL_x |
\(x'_{LL}\) |
State |
State in lead-lag |
v_str |
|
omega |
\(\omega\) |
ExtState |
Generator speed |
p.u. |
|
paux |
\(P_{aux}\) |
Algeb |
Auxiliary power input |
v_str |
|
pout |
\(P_{out}\) |
Algeb |
Turbine final output power |
v_str |
|
wref |
\(\omega_{ref}\) |
Algeb |
Speed reference variable |
v_str |
|
pref |
\(P_{ref}\) |
Algeb |
Reference power input |
v_str |
|
wd |
\(\omega_{dev}\) |
Algeb |
Generator speed deviation |
p.u. |
v_str |
pd |
\(P_{d}\) |
Algeb |
Pref plus speed deviation times gain |
p.u. |
v_str |
LL_y |
\(y_{LL}\) |
Algeb |
Output of lead-lag |
v_str |
|
tm |
\(\tau_{m}\) |
ExtAlgeb |
Mechanical power interface to SynGen |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
\(P_{d}\) |
LL_x |
\(x'_{LL}\) |
State |
\(y_{LAG}\) |
omega |
\(\omega\) |
ExtState |
|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0}\) |
pout |
\(P_{out}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0}\) |
pref |
\(P_{ref}\) |
Algeb |
\(\tau_{m0}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(0\) |
pd |
\(P_{d}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
LL_y |
\(y_{LL}\) |
Algeb |
\(y_{LAG}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
\(P_{d} - y_{LAG}\) |
\(T_1\) |
LL_x |
\(x'_{LL}\) |
State |
\(- x'_{LL} + y_{LAG}\) |
\(T_3\) |
omega |
\(\omega\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0} - P_{aux}\) |
pout |
\(P_{out}\) |
Algeb |
\(- P_{out} + u_{e} \left(- D_{t} \omega_{dev} + y_{LL}\right)\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0} - \omega_{ref}\) |
pref |
\(P_{ref}\) |
Algeb |
\(P_{ref0} - P_{ref}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(- \omega_{dev} + u_{e} \left(\omega - \omega_{ref}\right)\) |
pd |
\(P_{d}\) |
Algeb |
\(- P_{d} + u_{e} \left(- G \omega_{dev} + P_{aux} + P_{ref}\right)\) |
LL_y |
\(y_{LL}\) |
Algeb |
\(LL_{LT1 z1} LL_{LT2 z1} \left(- x'_{LL} + y_{LL}\right) + T_{2} \left(- x'_{LL} + y_{LAG}\right) + T_{3} x'_{LL} - T_{3} y_{LL}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
\(u_{e} \left(P_{out} - \tau_{m0}\right)\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ue |
\(u_{e}\) |
\(u u_{g}\) |
ConstService |
pref0 |
\(P_{ref0}\) |
\(\tau_{m0}\) |
ConstService |
paux0 |
\(P_{aux0}\) |
\(0\) |
ConstService |
gain |
\(G\) |
\(\frac{u_{e}}{R}\) |
ConstService |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LAG_lim |
\(lim_{LAG}\) |
AntiWindup |
Limiter in Lag |
LL_LT1 |
\(LT_{LL}\) |
LessThan |
|
LL_LT2 |
\(LT_{LL}\) |
LessThan |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LAG |
\(LAG\) |
LagAntiWindup |
|
LL |
\(LL\) |
LeadLag |
Config Fields in [TGOV1N]
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) |
TGOV1NDB#
TGOV1N turbine governor model with speed input deadband.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
syn |
Synchronous generator idx |
mandatory,unique |
|||
Tn |
\(T_n\) |
Turbine power rating. Equal to Sn if not provided. |
0 |
MVA |
|
wref0 |
\(\omega_{ref0}\) |
Base speed reference |
1 |
p.u. |
|
R |
\(R\) |
Speed regulation gain (mach. base default) |
0.050 |
p.u. |
ipower |
VMAX |
\(V_{max}\) |
Maximum valve position |
1.200 |
p.u. |
power |
VMIN |
\(V_{min}\) |
Minimum valve position |
0 |
p.u. |
power |
T1 |
\(T_1\) |
Valve time constant |
0.100 |
||
T2 |
\(T_2\) |
Lead-lag lead time constant |
0.200 |
||
T3 |
\(T_3\) |
Lead-lag lag time constant |
10 |
||
Dt |
\(D_t\) |
Turbine damping coefficient |
0 |
power |
|
dbL |
\(db_L\) |
Lower bound of deadband |
0 |
p.u. |
|
dbU |
\(db_U\) |
Upper bound of deadband |
0 |
p.u. |
|
Sg |
\(S_n\) |
Rated power from generator |
0 |
MVA |
|
ug |
\(u_g\) |
Generator connection status |
0 |
bool |
|
Vn |
\(V_n\) |
Rated voltage from generator |
0 |
kV |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
State in lag TF |
v_str |
|
LL_x |
\(x'_{LL}\) |
State |
State in lead-lag |
v_str |
|
omega |
\(\omega\) |
ExtState |
Generator speed |
p.u. |
|
paux |
\(P_{aux}\) |
Algeb |
Auxiliary power input |
v_str |
|
pout |
\(P_{out}\) |
Algeb |
Turbine final output power |
v_str |
|
wref |
\(\omega_{ref}\) |
Algeb |
Speed reference variable |
v_str |
|
pref |
\(P_{ref}\) |
Algeb |
Reference power input |
v_str |
|
wd |
\(\omega_{dev}\) |
Algeb |
Generator speed deviation |
p.u. |
v_str |
pd |
\(P_{d}\) |
Algeb |
Pref plus speed deviation times gain |
p.u. |
v_str |
LL_y |
\(y_{LL}\) |
Algeb |
Output of lead-lag |
v_str |
|
DB_y |
\(y_{DB}\) |
Algeb |
Deadband type 1 output |
v_str |
|
tm |
\(\tau_{m}\) |
ExtAlgeb |
Mechanical power interface to SynGen |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
\(P_{d}\) |
LL_x |
\(x'_{LL}\) |
State |
\(y_{LAG}\) |
omega |
\(\omega\) |
ExtState |
|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0}\) |
pout |
\(P_{out}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0}\) |
pref |
\(P_{ref}\) |
Algeb |
\(\tau_{m0}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(0\) |
pd |
\(P_{d}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
LL_y |
\(y_{LL}\) |
Algeb |
\(y_{LAG}\) |
DB_y |
\(y_{DB}\) |
Algeb |
\(1.0 DB_{db zl} \left(\omega_{dev} - db_{L}\right) + 1.0 DB_{db zu} \left(\omega_{dev} - db_{U}\right)\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
\(P_{d} - y_{LAG}\) |
\(T_1\) |
LL_x |
\(x'_{LL}\) |
State |
\(- x'_{LL} + y_{LAG}\) |
\(T_3\) |
omega |
\(\omega\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0} - P_{aux}\) |
pout |
\(P_{out}\) |
Algeb |
\(- D_{t} y_{DB} - P_{out} + y_{LL}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0} - \omega_{ref}\) |
pref |
\(P_{ref}\) |
Algeb |
\(P_{ref0} - P_{ref}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(- \omega_{dev} + u_{e} \left(\omega - \omega_{ref}\right)\) |
pd |
\(P_{d}\) |
Algeb |
\(- P_{d} + u_{e} \left(G y_{DB} + P_{aux} + P_{ref}\right)\) |
LL_y |
\(y_{LL}\) |
Algeb |
\(LL_{LT1 z1} LL_{LT2 z1} \left(- x'_{LL} + y_{LL}\right) + T_{2} \left(- x'_{LL} + y_{LAG}\right) + T_{3} x'_{LL} - T_{3} y_{LL}\) |
DB_y |
\(y_{DB}\) |
Algeb |
\(1.0 DB_{db zl} \left(\omega_{dev} - db_{L}\right) + 1.0 DB_{db zu} \left(\omega_{dev} - db_{U}\right) - y_{DB}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
\(u_{e} \left(P_{out} - \tau_{m0}\right)\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ue |
\(u_{e}\) |
\(u u_{g}\) |
ConstService |
pref0 |
\(P_{ref0}\) |
\(\tau_{m0}\) |
ConstService |
paux0 |
\(P_{aux0}\) |
\(0\) |
ConstService |
gain |
\(G\) |
\(\frac{u_{e}}{R}\) |
ConstService |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LAG_lim |
\(lim_{LAG}\) |
AntiWindup |
Limiter in Lag |
LL_LT1 |
\(LT_{LL}\) |
LessThan |
|
LL_LT2 |
\(LT_{LL}\) |
LessThan |
|
DB_db |
\(db_{DB}\) |
DeadBand |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LAG |
\(LAG\) |
LagAntiWindup |
|
LL |
\(LL\) |
LeadLag |
|
DB |
\(DB\) |
DeadBand1 |
deadband for speed deviation |
Config Fields in [TGOV1NDB]
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) |
IEEEG1#
IEEE Type 1 Speed-Governing Model.
If only one generator is connected, its idx must be given to syn, and syn2 must be left blank. Each generator must provide data in its Sn base.
syn is connected to the high-pressure output (PHP) and the optional syn2 is connected to the low- pressure output (PLP).
The speed deviation of generator 1 (syn) is measured. If the turbine rating Tn is not specified, the sum of Sn of all connected generators will be used.
Normally, K1 + K2 + ... + K8 = 1.0. If the second generator is not
connected, K1 + K3 + K5 + K7 = 1, and K2 + K4 + K6 + K8 = 0. If K1 to K8 do
not sum up to 1.0, they will be normalized. The normalized parameters are
called K1n through K8n.
If initialization error occurs for variable vs, it is due to the limits
PMIN and PMAX.
IEEEG1 does not yet support the change of reference (scheduling).
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
syn |
Synchronous generator idx |
mandatory,unique |
|||
Tn |
\(T_n\) |
Turbine power rating. Equal to Sn if not provided. |
0 |
MVA |
|
wref0 |
\(\omega_{ref0}\) |
Base speed reference |
1 |
p.u. |
|
syn2 |
Optional SynGen idx |
||||
K |
\(K\) |
Gain (1/R) in mach. base |
20 |
p.u. (power) |
power |
T1 |
\(T_1\) |
Gov. lag time const. |
1 |
||
T2 |
\(T_2\) |
Gov. lead time const. |
1 |
||
T3 |
\(T_3\) |
Valve controller time const. |
0.100 |
||
UO |
\(U_o\) |
Max. valve opening rate |
0.100 |
p.u./sec |
|
UC |
\(U_c\) |
Max. valve closing rate |
-0.100 |
p.u./sec |
|
PMAX |
\(P_{MAX}\) |
Max. turbine power |
5 |
power |
|
PMIN |
\(P_{MIN}\) |
Min. turbine power |
0 |
power |
|
T4 |
\(T_4\) |
Inlet piping/steam bowl time constant |
0.400 |
||
K1 |
\(K_1\) |
Fraction of power from HP |
0.500 |
||
K2 |
\(K_2\) |
Fraction of power from LP |
0 |
||
T5 |
\(T_5\) |
Time constant of 2nd boiler pass |
8 |
||
K3 |
\(K_3\) |
Fraction of HP shaft power after 2nd boiler pass |
0.500 |
||
K4 |
\(K_4\) |
Fraction of LP shaft power after 2nd boiler pass |
0 |
||
T6 |
\(T_6\) |
Time constant of 3rd boiler pass |
0.500 |
||
K5 |
\(K_5\) |
Fraction of HP shaft power after 3rd boiler pass |
0 |
||
K6 |
\(K_6\) |
Fraction of LP shaft power after 3rd boiler pass |
0 |
||
T7 |
\(T_7\) |
Time constant of 4th boiler pass |
0.050 |
||
K7 |
\(K_7\) |
Fraction of HP shaft power after 4th boiler pass |
0 |
||
K8 |
\(K_8\) |
Fraction of LP shaft power after 4th boiler pass |
0 |
||
Sg |
\(S_n\) |
Rated power from generator |
0 |
MVA |
|
ug |
\(u_g\) |
Generator connection status |
0 |
bool |
|
Vn |
\(V_n\) |
Rated voltage from generator |
0 |
kV |
|
Sg2 |
\(S_{n2}\) |
Rated power of Syn2 |
0 |
MVA |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
LL_x |
\(x'_{LL}\) |
State |
State in lead-lag |
v_str |
|
IAW_y |
\(y_{IAW}\) |
State |
AW Integrator output |
v_str |
|
L4_y |
\(y_{L4}\) |
State |
State in lag transfer function |
v_str |
|
L5_y |
\(y_{L5}\) |
State |
State in lag transfer function |
v_str |
|
L6_y |
\(y_{L6}\) |
State |
State in lag transfer function |
v_str |
|
L7_y |
\(y_{L7}\) |
State |
State in lag transfer function |
v_str |
|
omega |
\(\omega\) |
ExtState |
Generator speed |
p.u. |
|
paux |
\(P_{aux}\) |
Algeb |
Auxiliary power input |
v_str |
|
pout |
\(P_{out}\) |
Algeb |
Turbine final output power |
v_str |
|
wref |
\(\omega_{ref}\) |
Algeb |
Speed reference variable |
v_str |
|
wd |
\(\omega_{dev}\) |
Algeb |
Generator under speed |
p.u. |
v_str |
LL_y |
\(y_{LL}\) |
Algeb |
Output of lead-lag |
v_str |
|
vs |
\(V_{s}\) |
Algeb |
Valve speed |
v_str |
|
vsl |
\(V_{sl}\) |
Algeb |
Valve move speed after limiter |
v_str |
|
PHP |
\(P_{HP}\) |
Algeb |
HP output |
v_str |
|
PLP |
\(P_{LP}\) |
Algeb |
LP output |
v_str |
|
tm |
\(\tau_{m}\) |
ExtAlgeb |
Mechanical power interface to SynGen |
||
tm2 |
\(\tau_{m2}\) |
ExtAlgeb |
Mechanical power to syn2 |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
LL_x |
\(x'_{LL}\) |
State |
\(\omega_{dev}\) |
IAW_y |
\(y_{IAW}\) |
State |
\(tm_{012}\) |
L4_y |
\(y_{L4}\) |
State |
\(y_{IAW}\) |
L5_y |
\(y_{L5}\) |
State |
\(y_{L4}\) |
L6_y |
\(y_{L6}\) |
State |
\(y_{L5}\) |
L7_y |
\(y_{L7}\) |
State |
\(y_{L6}\) |
omega |
\(\omega\) |
ExtState |
|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0}\) |
pout |
\(P_{out}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(0\) |
LL_y |
\(y_{LL}\) |
Algeb |
\(\omega_{dev}\) |
vs |
\(V_{s}\) |
Algeb |
\(0\) |
vsl |
\(V_{sl}\) |
Algeb |
\(U_{c} z_{l}^{HL} + U_{o} z_{u}^{HL} + V_{s} z_{i}^{HL}\) |
PHP |
\(P_{HP}\) |
Algeb |
\(u_{e} \left(K_{1n} y_{L4} + K_{3n} y_{L5} + K_{5n} y_{L6} + K_{7n} y_{L7}\right)\) |
PLP |
\(P_{LP}\) |
Algeb |
\(u_{e} \left(K_{2n} y_{L4} + K_{4n} y_{L5} + K_{6n} y_{L6} + K_{8n} y_{L7}\right)\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
|
tm2 |
\(\tau_{m2}\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
LL_x |
\(x'_{LL}\) |
State |
\(\omega_{dev} - x'_{LL}\) |
\(T_1\) |
IAW_y |
\(y_{IAW}\) |
State |
\(V_{sl}\) |
\(1\) |
L4_y |
\(y_{L4}\) |
State |
\(y_{IAW} - y_{L4}\) |
\(T_4\) |
L5_y |
\(y_{L5}\) |
State |
\(y_{L4} - y_{L5}\) |
\(T_5\) |
L6_y |
\(y_{L6}\) |
State |
\(y_{L5} - y_{L6}\) |
\(T_6\) |
L7_y |
\(y_{L7}\) |
State |
\(y_{L6} - y_{L7}\) |
\(T_7\) |
omega |
\(\omega\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0} - P_{aux}\) |
pout |
\(P_{out}\) |
Algeb |
\(P_{HP} u_{e} - P_{out}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0} - \omega_{ref}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(- \omega_{dev} + u_{e} \left(- \omega + \omega_{ref}\right)\) |
LL_y |
\(y_{LL}\) |
Algeb |
\(K T_{1} x'_{LL} + K T_{2} \left(\omega_{dev} - x'_{LL}\right) + LL_{LT1 z1} LL_{LT2 z1} \left(- K x'_{LL} + y_{LL}\right) - T_{1} y_{LL}\) |
vs |
\(V_{s}\) |
Algeb |
\(- V_{s} + \frac{u_{e} \left(P_{aux} + tm_{012} - y_{IAW} + y_{LL}\right)}{T_{3}}\) |
vsl |
\(V_{sl}\) |
Algeb |
\(U_{c} z_{l}^{HL} + U_{o} z_{u}^{HL} + V_{s} z_{i}^{HL} - V_{sl}\) |
PHP |
\(P_{HP}\) |
Algeb |
\(- P_{HP} + u_{e} \left(K_{1n} y_{L4} + K_{3n} y_{L5} + K_{5n} y_{L6} + K_{7n} y_{L7}\right)\) |
PLP |
\(P_{LP}\) |
Algeb |
\(- P_{LP} + u_{e} \left(K_{2n} y_{L4} + K_{4n} y_{L5} + K_{6n} y_{L6} + K_{8n} y_{L7}\right)\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
\(u_{e} \left(P_{out} - \tau_{m0}\right)\) |
tm2 |
\(\tau_{m2}\) |
ExtAlgeb |
\(u_{e} z_{syn2} \left(P_{LP} - \tau_{m02}\right)\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ue |
\(u_{e}\) |
\(u u_{g}\) |
ConstService |
pref0 |
\(P_{ref0}\) |
\(\tau_{m0}\) |
ConstService |
paux0 |
\(P_{aux0}\) |
\(0\) |
ConstService |
_sumK18 |
\(\sum_{i=1}^8 K_i\) |
\(K_{1} + K_{2} + K_{3} + K_{4} + K_{5} + K_{6} + K_{7} + K_{8}\) |
ConstService |
_Kcoeff |
\(K_{coeff}\) |
\(\frac{1}{\sum_{i=1}^8 K_i}\) |
ConstService |
K1n |
\(K_{1n}\) |
\(K_{1} K_{coeff}\) |
ConstService |
K2n |
\(K_{2n}\) |
\(K_{2} K_{coeff}\) |
ConstService |
K3n |
\(K_{3n}\) |
\(K_{3} K_{coeff}\) |
ConstService |
K4n |
\(K_{4n}\) |
\(K_{4} K_{coeff}\) |
ConstService |
K5n |
\(K_{5n}\) |
\(K_{5} K_{coeff}\) |
ConstService |
K6n |
\(K_{6n}\) |
\(K_{6} K_{coeff}\) |
ConstService |
K7n |
\(K_{7n}\) |
\(K_{7} K_{coeff}\) |
ConstService |
K8n |
\(K_{8n}\) |
\(K_{8} K_{coeff}\) |
ConstService |
_tm0K2 |
\(_tm0K2\) |
\(\tau_{m0} z_{syn2} \left(K_{2n} + K_{4n} + K_{6n} + K_{8n}\right)\) |
PostInitService |
_tm02K1 |
\(_tm02K1\) |
\(\tau_{m02} \left(K_{1n} + K_{3n} + K_{5n} + K_{7n}\right)\) |
PostInitService |
tm012 |
\(tm012\) |
\(\tau_{m02} + \tau_{m0}\) |
ConstService |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LL_LT1 |
\(LT_{LL}\) |
LessThan |
|
LL_LT2 |
\(LT_{LL}\) |
LessThan |
|
HL |
\(HL\) |
HardLimiter |
Limiter on valve speed |
IAW_lim |
\(lim_{IAW}\) |
AntiWindup |
Limiter in integrator |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LL |
\(LL\) |
LeadLag |
Signal conditioning for wd |
IAW |
\(IAW\) |
IntegratorAntiWindup |
Valve position integrator |
L4 |
\(L4\) |
Lag |
first process |
L5 |
\(L5\) |
Lag |
second (reheat) process |
L6 |
\(L6\) |
Lag |
third process |
L7 |
\(L7\) |
Lag |
fourth (second reheat) process |
Config Fields in [IEEEG1]
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) |
IEESGO#
IEEE Standard Governor (IEESGO).
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
syn |
Synchronous generator idx |
mandatory,unique |
|||
Tn |
\(T_n\) |
Turbine power rating. Equal to Sn if not provided. |
0 |
MVA |
|
wref0 |
\(\omega_{ref0}\) |
Base speed reference |
1 |
p.u. |
|
T1 |
\(T_1\) |
Controller lag |
0.020 |
||
T2 |
\(T_2\) |
Lead compensation |
1 |
||
T3 |
\(T_3\) |
Governor lag |
1 |
||
T4 |
\(T_4\) |
Steam inlet delay |
0.500 |
||
T5 |
\(T_5\) |
Reheater delay |
10 |
||
T6 |
\(T_6\) |
Crossover delay |
0.500 |
||
K1 |
\(K_1\) |
1/pu regulation |
0.020 |
||
K2 |
\(K_2\) |
fraction K2 |
1 |
||
K3 |
\(K_3\) |
fraction K3 |
1 |
||
PMAX |
\(P_{MAX}\) |
Max. turbine power |
5 |
power |
|
PMIN |
\(P_{MIN}\) |
Min. turbine power |
0 |
power |
|
Sg |
\(S_n\) |
Rated power from generator |
0 |
MVA |
|
ug |
\(u_g\) |
Generator connection status |
0 |
bool |
|
Vn |
\(V_n\) |
Rated voltage from generator |
0 |
kV |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
F1_y |
\(y_{F1}\) |
State |
State in lag transfer function |
v_str |
|
F2_x |
\(x'_{F2}\) |
State |
State in lead-lag |
v_str |
|
F3_y |
\(y_{F3}\) |
State |
State in lag transfer function |
v_str |
|
F4_y |
\(y_{F4}\) |
State |
State in lag transfer function |
v_str |
|
F5_y |
\(y_{F5}\) |
State |
State in lag transfer function |
v_str |
|
omega |
\(\omega\) |
ExtState |
Generator speed |
p.u. |
|
paux |
\(P_{aux}\) |
Algeb |
Auxiliary power input |
v_str |
|
pout |
\(P_{out}\) |
Algeb |
Turbine final output power |
v_str |
|
wref |
\(\omega_{ref}\) |
Algeb |
Speed reference variable |
v_str |
|
F2_y |
\(y_{F2}\) |
Algeb |
Output of lead-lag |
v_str |
|
HL_x |
\(x_{HL}\) |
Algeb |
Value before limiter |
v_str |
|
HL_y |
\(y_{HL}\) |
Algeb |
Output after limiter and post gain |
v_str |
|
tm |
\(\tau_{m}\) |
ExtAlgeb |
Mechanical power interface to SynGen |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
F1_y |
\(y_{F1}\) |
State |
\(K_{1} u_{e} \left(\omega - \omega_{ref}\right)\) |
F2_x |
\(x'_{F2}\) |
State |
\(y_{F1}\) |
F3_y |
\(y_{F3}\) |
State |
\(1.0 y_{HL}\) |
F4_y |
\(y_{F4}\) |
State |
\(K_{2} y_{F3}\) |
F5_y |
\(y_{F5}\) |
State |
\(K_{3} y_{F4}\) |
omega |
\(\omega\) |
ExtState |
|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0}\) |
pout |
\(P_{out}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0}\) |
F2_y |
\(y_{F2}\) |
Algeb |
\(y_{F1}\) |
HL_x |
\(x_{HL}\) |
Algeb |
\(1.0 u_{e} \left(P_{aux} + P_{ref0} - y_{F2}\right)\) |
HL_y |
\(y_{HL}\) |
Algeb |
\(1.0 HL_{lim zi} x_{HL} + 1.0 HL_{lim zl} P_{MIN} + 1.0 HL_{lim zu} P_{MAX}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
F1_y |
\(y_{F1}\) |
State |
\(K_{1} u_{e} \left(\omega - \omega_{ref}\right) - y_{F1}\) |
\(T_1\) |
F2_x |
\(x'_{F2}\) |
State |
\(- x'_{F2} + y_{F1}\) |
\(T_3\) |
F3_y |
\(y_{F3}\) |
State |
\(- y_{F3} + 1.0 y_{HL}\) |
\(T_4\) |
F4_y |
\(y_{F4}\) |
State |
\(K_{2} y_{F3} - y_{F4}\) |
\(T_5\) |
F5_y |
\(y_{F5}\) |
State |
\(K_{3} y_{F4} - y_{F5}\) |
\(T_6\) |
omega |
\(\omega\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0} - P_{aux}\) |
pout |
\(P_{out}\) |
Algeb |
\(- P_{out} + u_{e} \left(y_{F3} \cdot \left(1 - K_{2}\right) + y_{F4} \cdot \left(1 - K_{3}\right) + y_{F5}\right)\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0} - \omega_{ref}\) |
F2_y |
\(y_{F2}\) |
Algeb |
\(F_{2 LT1 z1} F_{2 LT2 z1} \left(- 1.0 x'_{F2} + y_{F2}\right) + 1.0 T_{2} \left(- x'_{F2} + y_{F1}\right) + 1.0 T_{3} x'_{F2} - T_{3} y_{F2}\) |
HL_x |
\(x_{HL}\) |
Algeb |
\(1.0 u_{e} \left(P_{aux} + P_{ref0} - y_{F2}\right) - x_{HL}\) |
HL_y |
\(y_{HL}\) |
Algeb |
\(1.0 HL_{lim zi} x_{HL} + 1.0 HL_{lim zl} P_{MIN} + 1.0 HL_{lim zu} P_{MAX} - y_{HL}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
\(u_{e} \left(P_{out} - \tau_{m0}\right)\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ue |
\(u_{e}\) |
\(u u_{g}\) |
ConstService |
pref0 |
\(P_{ref0}\) |
\(\tau_{m0}\) |
ConstService |
paux0 |
\(P_{aux0}\) |
\(0\) |
ConstService |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
F2_LT1 |
\(LT_{F2}\) |
LessThan |
|
F2_LT2 |
\(LT_{F2}\) |
LessThan |
|
HL_lim |
\(lim_{HL}\) |
HardLimiter |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
F1 |
\(F1\) |
Lag |
|
F2 |
\(F2\) |
LeadLag |
|
HL |
\(HL\) |
GainLimiter |
|
F3 |
\(F3\) |
Lag |
|
F4 |
\(F4\) |
Lag |
|
F5 |
\(F5\) |
Lag |
Config Fields in [IEESGO]
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) |
GAST#
GAST turbine governor model.
Reference:
[1] Neplan, TURBINE-GOVERNOR GAST, [Online],
Available:
https://www.neplan.ch/wp-content/uploads/2015/08/Nep_TURBINES_GOV.pdf
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
syn |
Synchronous generator idx |
mandatory,unique |
|||
Tn |
\(T_n\) |
Turbine power rating. Equal to Sn if not provided. |
0 |
MVA |
|
wref0 |
\(\omega_{ref0}\) |
Base speed reference |
1 |
p.u. |
|
R |
\(R\) |
Speed regulation gain (mach. base default) |
0.050 |
p.u. |
ipower |
VMAX |
\(V_{max}\) |
Maximum valve position |
1.200 |
p.u. |
power |
VMIN |
\(V_{min}\) |
Minimum valve position |
0 |
p.u. |
power |
KT |
\(K_T\) |
Temperature limiter gain |
5 |
||
AT |
\(A_T\) |
Ambient temperature load limit |
1 |
power |
|
T1 |
\(T_1\) |
Valve time constant |
0.100 |
||
T2 |
\(T_2\) |
Lead-lag lead time constant |
0.200 |
||
T3 |
\(T_3\) |
Lead-lag lag time constant |
10 |
||
Dt |
\(D_t\) |
Turbine damping coefficient |
0 |
power |
|
Sg |
\(S_n\) |
Rated power from generator |
0 |
MVA |
|
ug |
\(u_g\) |
Generator connection status |
0 |
bool |
|
Vn |
\(V_n\) |
Rated voltage from generator |
0 |
kV |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
State in lag TF |
v_str |
|
LG2_y |
\(y_{LG2}\) |
State |
State in lag transfer function |
v_str |
|
LG3_y |
\(y_{LG3}\) |
State |
State in lag transfer function |
v_str |
|
omega |
\(\omega\) |
ExtState |
Generator speed |
p.u. |
|
paux |
\(P_{aux}\) |
Algeb |
Auxiliary power input |
v_str |
|
pout |
\(P_{out}\) |
Algeb |
Turbine final output power |
v_str |
|
wref |
\(\omega_{ref}\) |
Algeb |
Speed reference variable |
v_str |
|
pref |
\(P_{ref}\) |
Algeb |
Reference power input |
v_str |
|
wd |
\(\omega_{dev}\) |
Algeb |
Generator under speed |
p.u. |
v_str |
pd |
\(P_{d}\) |
Algeb |
Pref plus under speed times gain |
p.u. |
v_str |
v9 |
\(V_{9}\) |
Algeb |
V_9 for LVGate input |
v_str |
|
LVG_y |
\(y_{LVG}\) |
Algeb |
LVGate output |
v_str |
|
tm |
\(\tau_{m}\) |
ExtAlgeb |
Mechanical power interface to SynGen |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
\(y_{LVG}\) |
LG2_y |
\(y_{LG2}\) |
State |
\(y_{LAG}\) |
LG3_y |
\(y_{LG3}\) |
State |
\(y_{LG2}\) |
omega |
\(\omega\) |
ExtState |
|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0}\) |
pout |
\(P_{out}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0}\) |
pref |
\(P_{ref}\) |
Algeb |
\(R \tau_{m0}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(0\) |
pd |
\(P_{d}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
v9 |
\(V_{9}\) |
Algeb |
\(u_{e} \left(A_{T} + K_{T} \left(A_{T} - \tau_{m0}\right)\right)\) |
LVG_y |
\(y_{LVG}\) |
Algeb |
\(LVG_{lt z0} V_{9} + LVG_{lt z1} P_{d}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
LAG_y |
\(y_{LAG}\) |
State |
\(- y_{LAG} + y_{LVG}\) |
\(T_1\) |
LG2_y |
\(y_{LG2}\) |
State |
\(y_{LAG} - y_{LG2}\) |
\(T_2\) |
LG3_y |
\(y_{LG3}\) |
State |
\(y_{LG2} - y_{LG3}\) |
\(T_3\) |
omega |
\(\omega\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0} - P_{aux}\) |
pout |
\(P_{out}\) |
Algeb |
\(- P_{out} + u_{e} \left(- D_{t} \omega_{dev} + y_{LG2}\right)\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0} - \omega_{ref}\) |
pref |
\(P_{ref}\) |
Algeb |
\(P_{ref0} R - P_{ref}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(- \omega_{dev} + u_{e} \left(\omega - \omega_{ref}\right)\) |
pd |
\(P_{d}\) |
Algeb |
\(G u_{e} \left(P_{aux} + P_{ref} - \omega_{dev}\right) - P_{d}\) |
v9 |
\(V_{9}\) |
Algeb |
\(- V_{9} + u_{e} \left(A_{T} + K_{T} \left(A_{T} - y_{LG3}\right)\right)\) |
LVG_y |
\(y_{LVG}\) |
Algeb |
\(LVG_{lt z0} V_{9} + LVG_{lt z1} P_{d} - y_{LVG}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
\(u_{e} \left(P_{out} - \tau_{m0}\right)\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ue |
\(u_{e}\) |
\(u u_{g}\) |
ConstService |
pref0 |
\(P_{ref0}\) |
\(\tau_{m0}\) |
ConstService |
paux0 |
\(P_{aux0}\) |
\(0\) |
ConstService |
gain |
\(G\) |
\(\frac{u_{e}}{R}\) |
ConstService |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LVG_lt |
\(None_{LVG}\) |
LessThan |
|
LAG_lim |
\(lim_{LAG}\) |
AntiWindup |
Limiter in Lag |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LVG |
\(LVG\) |
LVGate |
LVGate |
LAG |
\(LAG\) |
LagAntiWindup |
|
LG2 |
\(LG2\) |
Lag |
Lag T2 |
LG3 |
\(LG3\) |
Lag |
Lag T3 |
Config Fields in [GAST]
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) |
HYGOV#
HYGOV turbine governor model.
Implements the PSS/E HYGOV model without deadband.
Reference:
[1] PSSE, Model Library, HYGOV
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
syn |
Synchronous generator idx |
mandatory,unique |
|||
Tn |
\(T_n\) |
Turbine power rating. Equal to Sn if not provided. |
0 |
MVA |
|
wref0 |
\(\omega_{ref0}\) |
Base speed reference |
1 |
p.u. |
|
R |
\(R\) |
Speed regulation gain (mach. base default) |
0.050 |
p.u. |
ipower |
r |
\(r\) |
Temporary droop (R<r) |
1 |
p.u. |
ipower |
GMAX |
\(G_{max}\) |
Maximum governor response |
1 |
p.u. |
power |
GMIN |
\(G_{min}\) |
Minimum governor response |
0 |
p.u. |
power |
VELM |
\(VELM\) |
Gate velocity limit |
0.300 |
p.u. |
power |
Tf |
\(T_f\) |
Filter time constant |
0.050 |
||
Tr |
\(T_r\) |
Governor time constant |
1 |
||
Tg |
\(T_g\) |
Servo time constant |
0.050 |
||
Dt |
\(D_t\) |
Turbine damping coefficient |
0 |
power |
|
qNL |
\(q_{NL}\) |
No-load flow at nominal head |
0.100 |
power |
|
Tw |
\(T_w\) |
Water inertia time constant constant |
1 |
||
At |
\(A_t\) |
Turbine gain |
1 |
||
Sg |
\(S_n\) |
Rated power from generator |
0 |
MVA |
|
ug |
\(u_g\) |
Generator connection status |
0 |
bool |
|
Vn |
\(V_n\) |
Rated voltage from generator |
0 |
kV |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
LG_y |
\(y_{LG}\) |
State |
State in lag transfer function |
v_str |
|
gtpos |
\(\delta\) |
State |
State in gate position (c) |
rad |
v_str |
LAG_y |
\(y_{LAG}\) |
State |
State in lag transfer function |
v_str |
|
q_y |
\(y_{q}\) |
State |
Integrator output |
v_str |
|
omega |
\(\omega\) |
ExtState |
Generator speed |
p.u. |
|
paux |
\(P_{aux}\) |
Algeb |
Auxiliary power input |
v_str |
|
pout |
\(P_{out}\) |
Algeb |
Turbine final output power |
v_str |
|
wref |
\(\omega_{ref}\) |
Algeb |
Speed reference variable |
v_str |
|
pref |
\(P_{ref}\) |
Algeb |
Reference power input |
v_str |
|
wd |
\(\omega_{dev}\) |
Algeb |
Generator speed deviation |
p.u. |
v_str |
pd |
\(P_{d}\) |
Algeb |
Pref plus speed deviation times gain |
p.u. |
v_str |
dg |
\(dg\) |
Algeb |
desired gate (c) |
p.u. |
v_str |
h |
\(h\) |
Algeb |
turbine head |
p.u. |
v_str |
tm |
\(\tau_{m}\) |
ExtAlgeb |
Mechanical power interface to SynGen |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
LG_y |
\(y_{LG}\) |
State |
\(P_{d}\) |
gtpos |
\(\delta\) |
State |
\(q_{0}\) |
LAG_y |
\(y_{LAG}\) |
State |
\(dg\) |
q_y |
\(y_{q}\) |
State |
\(q_{0}\) |
omega |
\(\omega\) |
ExtState |
|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0}\) |
pout |
\(P_{out}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0}\) |
pref |
\(P_{ref}\) |
Algeb |
\(R q_{0}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(0\) |
pd |
\(P_{d}\) |
Algeb |
\(0\) |
dg |
\(dg\) |
Algeb |
\(q_{0}\) |
h |
\(h\) |
Algeb |
\(1\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
LG_y |
\(y_{LG}\) |
State |
\(P_{d} - y_{LG}\) |
\(T_f\) |
gtpos |
\(\delta\) |
State |
\(y_{LG}\) |
|
LAG_y |
\(y_{LAG}\) |
State |
\(dg - y_{LAG}\) |
\(T_g\) |
q_y |
\(y_{q}\) |
State |
\(1 - \frac{y_{q}^{2}}{y_{LAG}^{2}}\) |
\(T_w\) |
omega |
\(\omega\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0} - P_{aux}\) |
pout |
\(P_{out}\) |
Algeb |
\(- P_{out} + u_{e} \left(A_{t} h \left(- q_{NL} + y_{q}\right) - D_{t} \omega_{dev} y_{LAG}\right)\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0} - \omega_{ref}\) |
pref |
\(P_{ref}\) |
Algeb |
\(- P_{ref} + R q_{0}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(- \omega_{dev} + u_{e} \left(\omega - \omega_{ref}\right)\) |
pd |
\(P_{d}\) |
Algeb |
\(- P_{d} + u_{e} \left(P_{aux} + P_{ref} - R dg - \omega_{dev}\right)\) |
dg |
\(dg\) |
Algeb |
\(1/r y_{LG} + \delta - dg\) |
h |
\(h\) |
Algeb |
\(- h + \frac{y_{q}^{2}}{y_{LAG}^{2}}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
\(u_{e} \left(P_{out} - \tau_{m0}\right)\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ue |
\(u_{e}\) |
\(u u_{g}\) |
ConstService |
pref0 |
\(P_{ref0}\) |
\(\tau_{m0}\) |
ConstService |
paux0 |
\(P_{aux0}\) |
\(0\) |
ConstService |
VELMn |
\(-VELM\) |
\(- VELM\) |
ConstService |
tr |
\(r*Tr\) |
\(T_{r} r\) |
ConstService |
gr |
\(1/r\) |
\(\frac{1}{r}\) |
ConstService |
ratel |
\(rate_l\) |
\(- 1/r - VELM\) |
ConstService |
rateu |
\(rate_u\) |
\(- 1/r + VELM\) |
ConstService |
q0 |
\(q_0\) |
\(q_{NL} + \frac{\tau_{m0}}{A_{t}}\) |
ConstService |
dgl |
\(dg_{lower}\) |
\(- 1/r y_{LG} - VELM\) |
VarService |
dgu |
\(dg_{upper}\) |
\(- 1/r y_{LG} + VELM\) |
VarService |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
dg_lim |
\(lim_{dg}\) |
AntiWindupRate |
gate velocity and position limiter |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LG |
\(LG\) |
Lag |
filter after speed deviation (e) |
LAG |
\(LAG\) |
Lag |
gate opening (g) |
q |
\(q\) |
Integrator |
turbine flow (q) |
Config Fields in [HYGOV]
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) |
HYGOVDB#
HYGOV turbine governor model with speed input deadband.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
syn |
Synchronous generator idx |
mandatory,unique |
|||
Tn |
\(T_n\) |
Turbine power rating. Equal to Sn if not provided. |
0 |
MVA |
|
wref0 |
\(\omega_{ref0}\) |
Base speed reference |
1 |
p.u. |
|
R |
\(R\) |
Speed regulation gain (mach. base default) |
0.050 |
p.u. |
ipower |
r |
\(r\) |
Temporary droop (R<r) |
1 |
p.u. |
ipower |
GMAX |
\(G_{max}\) |
Maximum governor response |
1 |
p.u. |
power |
GMIN |
\(G_{min}\) |
Minimum governor response |
0 |
p.u. |
power |
VELM |
\(VELM\) |
Gate velocity limit |
0.300 |
p.u. |
power |
Tf |
\(T_f\) |
Filter time constant |
0.050 |
||
Tr |
\(T_r\) |
Governor time constant |
1 |
||
Tg |
\(T_g\) |
Servo time constant |
0.050 |
||
Dt |
\(D_t\) |
Turbine damping coefficient |
0 |
power |
|
qNL |
\(q_{NL}\) |
No-load flow at nominal head |
0.100 |
power |
|
Tw |
\(T_w\) |
Water inertia time constant constant |
1 |
||
At |
\(A_t\) |
Turbine gain |
1 |
||
dbL |
\(db_L\) |
Lower bound of deadband |
0 |
p.u. |
|
dbU |
\(db_U\) |
Upper bound of deadband |
0 |
p.u. |
|
Sg |
\(S_n\) |
Rated power from generator |
0 |
MVA |
|
ug |
\(u_g\) |
Generator connection status |
0 |
bool |
|
Vn |
\(V_n\) |
Rated voltage from generator |
0 |
kV |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
LG_y |
\(y_{LG}\) |
State |
State in lag transfer function |
v_str |
|
gtpos |
\(\delta\) |
State |
State in gate position (c) |
rad |
v_str |
LAG_y |
\(y_{LAG}\) |
State |
State in lag transfer function |
v_str |
|
q_y |
\(y_{q}\) |
State |
Integrator output |
v_str |
|
omega |
\(\omega\) |
ExtState |
Generator speed |
p.u. |
|
paux |
\(P_{aux}\) |
Algeb |
Auxiliary power input |
v_str |
|
pout |
\(P_{out}\) |
Algeb |
Turbine final output power |
v_str |
|
wref |
\(\omega_{ref}\) |
Algeb |
Speed reference variable |
v_str |
|
pref |
\(P_{ref}\) |
Algeb |
Reference power input |
v_str |
|
wd |
\(\omega_{dev}\) |
Algeb |
Generator speed deviation |
p.u. |
v_str |
pd |
\(P_{d}\) |
Algeb |
Pref plus speed deviation times gain |
p.u. |
v_str |
dg |
\(dg\) |
Algeb |
desired gate (c) |
p.u. |
v_str |
h |
\(h\) |
Algeb |
turbine head |
p.u. |
v_str |
DB_y |
\(y_{DB}\) |
Algeb |
Deadband type 1 output |
v_str |
|
tm |
\(\tau_{m}\) |
ExtAlgeb |
Mechanical power interface to SynGen |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
LG_y |
\(y_{LG}\) |
State |
\(P_{d}\) |
gtpos |
\(\delta\) |
State |
\(q_{0}\) |
LAG_y |
\(y_{LAG}\) |
State |
\(dg\) |
q_y |
\(y_{q}\) |
State |
\(q_{0}\) |
omega |
\(\omega\) |
ExtState |
|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0}\) |
pout |
\(P_{out}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0}\) |
pref |
\(P_{ref}\) |
Algeb |
\(R q_{0}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(0\) |
pd |
\(P_{d}\) |
Algeb |
\(0\) |
dg |
\(dg\) |
Algeb |
\(q_{0}\) |
h |
\(h\) |
Algeb |
\(1\) |
DB_y |
\(y_{DB}\) |
Algeb |
\(1.0 DB_{db zl} \left(\omega_{dev} - db_{L}\right) + 1.0 DB_{db zu} \left(\omega_{dev} - db_{U}\right)\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
LG_y |
\(y_{LG}\) |
State |
\(P_{d} - y_{LG}\) |
\(T_f\) |
gtpos |
\(\delta\) |
State |
\(y_{LG}\) |
|
LAG_y |
\(y_{LAG}\) |
State |
\(dg - y_{LAG}\) |
\(T_g\) |
q_y |
\(y_{q}\) |
State |
\(1 - \frac{y_{q}^{2}}{y_{LAG}^{2}}\) |
\(T_w\) |
omega |
\(\omega\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0} - P_{aux}\) |
pout |
\(P_{out}\) |
Algeb |
\(- P_{out} + u_{e} \left(A_{t} h \left(- q_{NL} + y_{q}\right) - D_{t} \omega_{dev} y_{LAG}\right)\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0} - \omega_{ref}\) |
pref |
\(P_{ref}\) |
Algeb |
\(- P_{ref} + R q_{0}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(- \omega_{dev} + u_{e} \left(\omega - \omega_{ref}\right)\) |
pd |
\(P_{d}\) |
Algeb |
\(- P_{d} + u_{e} \left(P_{aux} + P_{ref} - R dg - y_{DB}\right)\) |
dg |
\(dg\) |
Algeb |
\(1/r y_{LG} + \delta - dg\) |
h |
\(h\) |
Algeb |
\(- h + \frac{y_{q}^{2}}{y_{LAG}^{2}}\) |
DB_y |
\(y_{DB}\) |
Algeb |
\(1.0 DB_{db zl} \left(\omega_{dev} - db_{L}\right) + 1.0 DB_{db zu} \left(\omega_{dev} - db_{U}\right) - y_{DB}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
\(u_{e} \left(P_{out} - \tau_{m0}\right)\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ue |
\(u_{e}\) |
\(u u_{g}\) |
ConstService |
pref0 |
\(P_{ref0}\) |
\(\tau_{m0}\) |
ConstService |
paux0 |
\(P_{aux0}\) |
\(0\) |
ConstService |
VELMn |
\(-VELM\) |
\(- VELM\) |
ConstService |
tr |
\(r*Tr\) |
\(T_{r} r\) |
ConstService |
gr |
\(1/r\) |
\(\frac{1}{r}\) |
ConstService |
ratel |
\(rate_l\) |
\(- 1/r - VELM\) |
ConstService |
rateu |
\(rate_u\) |
\(- 1/r + VELM\) |
ConstService |
q0 |
\(q_0\) |
\(q_{NL} + \frac{\tau_{m0}}{A_{t}}\) |
ConstService |
dgl |
\(dg_{lower}\) |
\(- 1/r y_{LG} - VELM\) |
VarService |
dgu |
\(dg_{upper}\) |
\(- 1/r y_{LG} + VELM\) |
VarService |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
dg_lim |
\(lim_{dg}\) |
AntiWindupRate |
gate velocity and position limiter |
DB_db |
\(db_{DB}\) |
DeadBand |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
LG |
\(LG\) |
Lag |
filter after speed deviation (e) |
LAG |
\(LAG\) |
Lag |
gate opening (g) |
q |
\(q\) |
Integrator |
turbine flow (q) |
DB |
\(DB\) |
DeadBand1 |
deadband for speed deviation |
Config Fields in [HYGOVDB]
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) |
HYGOV4#
HYGOV4 turbine governor model.
Implements the PSS/E HYGOV4 model with the following ignored:
input deadband DB1
valve position deadband DB2
nonlinear function bewteen GV and P_{GV}
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
syn |
Synchronous generator idx |
mandatory,unique |
|||
Tn |
\(T_n\) |
Turbine power rating. Equal to Sn if not provided. |
0 |
MVA |
|
wref0 |
\(\omega_{ref0}\) |
Base speed reference |
1 |
p.u. |
|
Rperm |
\(R_{perm}\) |
Speed Regulation Gain (mach. base default) |
0.500 |
p.u. |
ipower |
Rtemp |
\(R_{temp}\) |
Temporary Droop (Rtemp < Rperm) |
1 |
p.u. |
ipower |
UO |
\(U_O\) |
Maximum Gate opening velocity |
1 |
p.u. |
power |
UC |
\(U_C\) |
Maximum Gate closing velocity |
0 |
p.u. |
power |
PMAX |
\(P_{MAX}\) |
Maximum Gate opening |
1 |
p.u. |
power |
PMIN |
\(P_{MIN}\) |
Minimum Gate opening |
0 |
p.u. |
power |
Tp |
\(T_p\) |
Pilot servo time constant |
0.050 |
||
Tg |
\(T_g\) |
Gate servo time constant |
0.050 |
||
Tr |
\(T_r\) |
Dashpot time constant |
0.050 |
||
Tw |
\(T_w\) |
Water inertia time constant |
1 |
||
At |
\(A_t\) |
Turbine gain |
1 |
||
Dturb |
\(D_{turb}\) |
Turbine Damping Factor |
0 |
power |
|
Hdam |
\(H_{dam}\) |
Head available at dam |
1 |
power |
|
qNL |
\(q_{NL}\) |
No-Load flow at nominal head |
0.100 |
power |
|
Sg |
\(S_n\) |
Rated power from generator |
0 |
MVA |
|
ug |
\(u_g\) |
Generator connection status |
0 |
bool |
|
Vn |
\(V_n\) |
Rated voltage from generator |
0 |
kV |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
GATE_y |
\(y_{GATE}\) |
State |
AW Integrator output |
v_str |
|
WO_x |
\(x'_{WO}\) |
State |
State in washout filter |
v_str |
|
LAG_y |
\(y_{LAG}\) |
State |
State in lag transfer function |
v_str |
|
q_y |
\(y_{q}\) |
State |
Integrator output |
v_str |
|
omega |
\(\omega\) |
ExtState |
Generator speed |
p.u. |
|
paux |
\(P_{aux}\) |
Algeb |
Auxiliary power input |
v_str |
|
pout |
\(P_{out}\) |
Algeb |
Turbine final output power |
v_str |
|
wref |
\(\omega_{ref}\) |
Algeb |
Speed reference variable |
v_str |
|
pref |
\(P_{ref}\) |
Algeb |
Reference power input |
v_str |
|
wd |
\(\omega_{dev}\) |
Algeb |
Generator speed deviation |
p.u. |
v_str |
SV_x |
\(x_{SV}\) |
Algeb |
Value before limiter |
v_str |
|
SV_y |
\(y_{SV}\) |
Algeb |
Output after limiter and post gain |
v_str |
|
WO_y |
\(y_{WO}\) |
Algeb |
Output of washout filter |
v_str |
|
Psum |
\(P_{sum}\) |
Algeb |
summation of power input to servo |
p.u. |
v_str |
trhead |
\(trhead\) |
Algeb |
turbine head |
p.u. |
v_str |
tm |
\(\tau_{m}\) |
ExtAlgeb |
Mechanical power interface to SynGen |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
GATE_y |
\(y_{GATE}\) |
State |
\(\frac{q_{0}}{H_{dam}^{0.5}}\) |
WO_x |
\(x'_{WO}\) |
State |
\(y_{GATE}\) |
LAG_y |
\(y_{LAG}\) |
State |
\(P_{sum}\) |
q_y |
\(y_{q}\) |
State |
\(q_{0}\) |
omega |
\(\omega\) |
ExtState |
|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0}\) |
pout |
\(P_{out}\) |
Algeb |
\(\tau_{m0} u_{e}\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0}\) |
pref |
\(P_{ref}\) |
Algeb |
\(\frac{R_{perm} q_{0}}{H_{dam}^{0.5}}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(0\) |
SV_x |
\(x_{SV}\) |
Algeb |
\(1/T_{g} y_{LAG}\) |
SV_y |
\(y_{SV}\) |
Algeb |
\(SV_{lim zi} x_{SV} + SV_{lim zl} U_{C} + SV_{lim zu} U_{O}\) |
WO_y |
\(y_{WO}\) |
Algeb |
\(0\) |
Psum |
\(P_{sum}\) |
Algeb |
\(0\) |
trhead |
\(trhead\) |
Algeb |
\(H_{dam}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
GATE_y |
\(y_{GATE}\) |
State |
\(y_{SV}\) |
\(1\) |
WO_x |
\(x'_{WO}\) |
State |
\(- x'_{WO} + y_{GATE}\) |
\(T_r\) |
LAG_y |
\(y_{LAG}\) |
State |
\(P_{sum} - y_{LAG}\) |
\(T_p\) |
q_y |
\(y_{q}\) |
State |
\(H_{dam} - trhead\) |
\(T_w\) |
omega |
\(\omega\) |
ExtState |
\(0\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
paux |
\(P_{aux}\) |
Algeb |
\(P_{aux0} - P_{aux}\) |
pout |
\(P_{out}\) |
Algeb |
\(- P_{out} + u_{e} \left(A_{t} trhead \left(- q_{NL} + y_{q}\right) - D_{turb} \omega_{dev} y_{GATE}\right)\) |
wref |
\(\omega_{ref}\) |
Algeb |
\(\omega_{ref0} - \omega_{ref}\) |
pref |
\(P_{ref}\) |
Algeb |
\(\frac{R_{perm} q_{0}}{H_{dam}^{0.5}} - P_{ref}\) |
wd |
\(\omega_{dev}\) |
Algeb |
\(- \omega_{dev} + u_{e} \left(\omega - \omega_{ref}\right)\) |
SV_x |
\(x_{SV}\) |
Algeb |
\(1/T_{g} y_{LAG} - x_{SV}\) |
SV_y |
\(y_{SV}\) |
Algeb |
\(SV_{lim zi} x_{SV} + SV_{lim zl} U_{C} + SV_{lim zu} U_{O} - y_{SV}\) |
WO_y |
\(y_{WO}\) |
Algeb |
\(R_{temp} * T_r \left(- x'_{WO} + y_{GATE}\right) - T_{r} y_{WO}\) |
Psum |
\(P_{sum}\) |
Algeb |
\(- P_{sum} + u_{e} \left(P_{aux} + P_{ref} - R_{perm} y_{GATE} - \omega_{dev} - y_{WO}\right)\) |
trhead |
\(trhead\) |
Algeb |
\(- trhead + \frac{y_{q}^{2}}{y_{GATE}^{2}}\) |
tm |
\(\tau_{m}\) |
ExtAlgeb |
\(u_{e} \left(P_{out} - \tau_{m0}\right)\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
ue |
\(u_{e}\) |
\(u u_{g}\) |
ConstService |
pref0 |
\(P_{ref0}\) |
\(\tau_{m0}\) |
ConstService |
paux0 |
\(P_{aux0}\) |
\(0\) |
ConstService |
iTg |
\(1/T_g\) |
\(\frac{u}{T_{g}}\) |
ConstService |
R |
\(R_{temp} + R_{perm}\) |
\(R_{perm} + R_{temp}\) |
ConstService |
TrRtemp |
\(R_{temp} * T_r\) |
\(R_{temp} T_{r}\) |
ConstService |
q0 |
\(q_0\) |
\(q_{NL} + \frac{\tau_{m0}}{A_{t} H_{dam}}\) |
ConstService |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
SV_lim |
\(lim_{SV}\) |
HardLimiter |
|
GATE_lim |
\(lim_{GATE}\) |
AntiWindup |
Limiter in integrator |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
SV |
\(SV\) |
GainLimiter |
servo gain and limiters |
GATE |
\(GATE\) |
IntegratorAntiWindup |
Gate position |
WO |
\(WO\) |
Washout |
Washout feedback with T_r |
LAG |
\(LAG\) |
Lag |
lag block with T_p, outputs velocity |
q |
\(q\) |
Integrator |
turbine flow (q) |
Config Fields in [HYGOV4]
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) |