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
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. |
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. |
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. |
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.
New TGOV1 model with pref and paux summed after the gain. This model is useful for incorporating AGC and scheduling signals without having to know the droop.
Scheduling changes should write to the v fields of pref0 and qref0 in place. AGC signal should write to that of paux0 in place.
Modifying tm0 is not allowed.
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. |
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. |
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.
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. |
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_{1} y_{L4} + K_{3} y_{L5} + K_{5} y_{L6} + K_{7} y_{L7}\right)\) |
PLP |
\(P_{LP}\) |
Algeb |
\(u_{e} \left(K_{2} y_{L4} + K_{4} y_{L5} + K_{6} y_{L6} + K_{8} 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_{1} y_{L4} + K_{3} y_{L5} + K_{5} y_{L6} + K_{7} y_{L7}\right)\) |
PLP |
\(P_{LP}\) |
Algeb |
\(- P_{LP} + u_{e} \left(K_{2} y_{L4} + K_{4} y_{L5} + K_{6} y_{L6} + K_{8} 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 |
_tm0K2 |
\(_tm0K2\) |
\(\tau_{m0} z_{syn2} \left(K_{2} + K_{4} + K_{6} + K_{8}\right)\) |
PostInitService |
_tm02K1 |
\(_tm02K1\) |
\(\tau_{m02} \left(K_{1} + K_{3} + K_{5} + K_{7}\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 acceleration |
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. |
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. |
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. |
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. |
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) |