StaticGen#
Static Generator Group.
The generator types and fuel types are referenced from MATPOWER.
Generator Types#
- The following codes represent the types of generators:
BA : Energy Storage, Battery
CE : Energy Storage, Compressed Air
CP : Energy Storage, Concentrated Solar Power
FW : Energy Storage, Flywheel
PS : Hydraulic Turbine, Reversible (pumped storage)
ES : Energy Storage, Other
ST : Steam Turbine (includes nuclear, geothermal, and solar steam)
GT : Combustion (Gas) Turbine
IC : Internal Combustion Engine (diesel, piston, reciprocating)
CA : Combined Cycle Steam Part
CT : Combined Cycle Combustion Turbine Part
CS : Combined Cycle Single Shaft
CC : Combined Cycle Total Unit
HA : Hydrokinetic, Axial Flow Turbine
HB : Hydrokinetic, Wave Buoy
HK : Hydrokinetic, Other
HY : Hydroelectric Turbine
BT : Turbines Used in a Binary Cycle
PV : Photovoltaic
WT : Wind Turbine, Onshore
WS : Wind Turbine, Offshore
FC : Fuel Cell
OT : Other
UN : Unknown
JE : Jet Engine
NB : ST - Boiling Water Nuclear Reactor
NG : ST - Graphite Nuclear Reactor
NH : ST - High Temperature Gas Nuclear Reactor
NP : ST - Pressurized Water Nuclear Reactor
IT : Internal Combustion Turbo Charged
SC : Synchronous Condenser
DC : DC ties
MP : Motor/Pump
W1 : Wind Turbine, Type 1
W2 : Wind Turbine, Type 2
W3 : Wind Turbine, Type 3
W4 : Wind Turbine, Type 4
SV : Static Var Compensator
DL : Dispatchable Load
Fuel Types#
- The following codes represent the fuel types:
biomass : Biomass
coal : Coal
dfo : Distillate Fuel Oil
geothermal : Geothermal
hydro : Hydro
hydrops : Hydro Pumped Storage
jetfuel : Jet Fuel
lng : Liquefied Natural Gas
ng : Natural Gas
nuclear : Nuclear
oil : Unspecified Oil
refuse : Refuse, Municipal Solid Waste
rfo : Residual Fuel Oil
solar : Solar
syncgen : Synchronous Condenser
wasteheat : Waste Heat
wind : Wind
wood : Wood or Wood Waste
other : Other
unknown : Unknown
dl : Dispatchable Load
ess : Energy Storage System
Notes#
For co-simulation with ANDES, refer to the ANDES StaticGen Documentation for replacing static generators with dynamic generators.
Common Parameters: u, name, idx, bus, Sn, Vn, p0, q0, ra, xs, subidx, pmax, pmin, pg0, ctrl, R10, td1, td2, area, zone, gentype, genfuel
Common Variables: p, q
Slack#
Slack generator model.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
Sn |
\(S_n\) |
Power rating |
100 |
non_zero |
|
Vn |
\(V_n\) |
AC voltage rating |
110 |
non_zero |
|
subidx |
index for generators on the same bus |
||||
bus |
idx of the installed bus |
mandatory |
|||
busr |
bus idx for remote voltage control |
||||
p0 |
\(p_0\) |
active power set point in system base |
0 |
p.u. |
|
q0 |
\(q_0\) |
reactive power set point in system base |
0 |
p.u. |
|
pmax |
\(p_{max}\) |
maximum active power in system base |
999 |
p.u. |
|
pmin |
\(p_{min}\) |
minimum active power in system base |
-1 |
p.u. |
|
qmax |
\(q_{max}\) |
maximim reactive power in system base |
999 |
p.u. |
|
qmin |
\(q_{min}\) |
minimum reactive power in system base |
-999 |
p.u. |
|
v0 |
\(v_0\) |
voltage set point |
1 |
||
vmax |
\(v_{max}\) |
maximum voltage voltage |
1.400 |
||
vmin |
\(v_{min}\) |
minimum allowed voltage |
0.600 |
||
ra |
\(r_a\) |
armature resistance |
0 |
||
xs |
\(x_s\) |
armature reactance |
0.300 |
||
wmod |
\(w_{mod}\) |
Machine ctrl. mode [PSS/E] |
0 |
int |
|
a0 |
\(\theta_0\) |
reference angle set point |
0 |
||
ctrl |
\(c_{trl}\) |
generator controllability |
1 |
bool |
|
uf |
\(u_{f}\) |
enforced on/off status; 0 unenforced, 1 enforced on, -1 enforced off |
0 |
int |
|
Pc1 |
\(P_{c1}\) |
lower real power output of PQ capability curve |
0 |
p.u. |
|
Pc2 |
\(P_{c2}\) |
upper real power output of PQ capability curve |
0 |
p.u. |
|
Qc1min |
\(Q_{c1min}\) |
minimum reactive power output at Pc1 |
0 |
p.u. |
|
Qc1max |
\(Q_{c1max}\) |
maximum reactive power output at Pc1 |
0 |
p.u. |
|
Qc2min |
\(Q_{c2min}\) |
minimum reactive power output at Pc2 |
0 |
p.u. |
|
Qc2max |
\(Q_{c2max}\) |
maximum reactive power output at Pc2 |
0 |
p.u. |
|
Ragc |
\(R_{agc}\) |
ramp rate for load following/AGC |
999 |
p.u./h |
|
R10 |
\(R_{10}\) |
ramp rate for 10 minute reserves |
999 |
p.u./h |
|
R30 |
\(R_{30}\) |
30 minute ramp rate |
999 |
p.u./h |
|
Rq |
\(R_{q}\) |
ramp rate for reactive power (2 sec timescale) |
999 |
p.u./h |
|
apf |
\(a_{pf}\) |
area participation factor |
0 |
||
pg0 |
\(p_{g0}\) |
active power start point (system base) |
0 |
p.u. |
|
td1 |
\(t_{d1}\) |
minimum ON duration |
1 |
h |
|
td2 |
\(t_{d2}\) |
minimum OFF duration |
0.500 |
h |
|
gentype |
\(g_{type}\) |
generator type |
|||
genfuel |
\(g_{fuel}\) |
generator fuel type |
|||
area |
Retrieved area idx |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
|---|---|---|---|---|
ud |
\(u_d\) |
Algeb |
commitment decision |
bool |
p |
\(p\) |
Algeb |
active power generation |
p.u. |
q |
\(q\) |
Algeb |
reactive power generation |
p.u. |
PV#
PV generator model.
TODO: implement type conversion in config
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
Sn |
\(S_n\) |
Power rating |
100 |
non_zero |
|
Vn |
\(V_n\) |
AC voltage rating |
110 |
non_zero |
|
subidx |
index for generators on the same bus |
||||
bus |
idx of the installed bus |
mandatory |
|||
busr |
bus idx for remote voltage control |
||||
p0 |
\(p_0\) |
active power set point in system base |
0 |
p.u. |
|
q0 |
\(q_0\) |
reactive power set point in system base |
0 |
p.u. |
|
pmax |
\(p_{max}\) |
maximum active power in system base |
999 |
p.u. |
|
pmin |
\(p_{min}\) |
minimum active power in system base |
-1 |
p.u. |
|
qmax |
\(q_{max}\) |
maximim reactive power in system base |
999 |
p.u. |
|
qmin |
\(q_{min}\) |
minimum reactive power in system base |
-999 |
p.u. |
|
v0 |
\(v_0\) |
voltage set point |
1 |
||
vmax |
\(v_{max}\) |
maximum voltage voltage |
1.400 |
||
vmin |
\(v_{min}\) |
minimum allowed voltage |
0.600 |
||
ra |
\(r_a\) |
armature resistance |
0 |
||
xs |
\(x_s\) |
armature reactance |
0.300 |
||
wmod |
\(w_{mod}\) |
Machine ctrl. mode [PSS/E] |
0 |
int |
|
ctrl |
\(c_{trl}\) |
generator controllability |
1 |
bool |
|
uf |
\(u_{f}\) |
enforced on/off status; 0 unenforced, 1 enforced on, -1 enforced off |
0 |
int |
|
Pc1 |
\(P_{c1}\) |
lower real power output of PQ capability curve |
0 |
p.u. |
|
Pc2 |
\(P_{c2}\) |
upper real power output of PQ capability curve |
0 |
p.u. |
|
Qc1min |
\(Q_{c1min}\) |
minimum reactive power output at Pc1 |
0 |
p.u. |
|
Qc1max |
\(Q_{c1max}\) |
maximum reactive power output at Pc1 |
0 |
p.u. |
|
Qc2min |
\(Q_{c2min}\) |
minimum reactive power output at Pc2 |
0 |
p.u. |
|
Qc2max |
\(Q_{c2max}\) |
maximum reactive power output at Pc2 |
0 |
p.u. |
|
Ragc |
\(R_{agc}\) |
ramp rate for load following/AGC |
999 |
p.u./h |
|
R10 |
\(R_{10}\) |
ramp rate for 10 minute reserves |
999 |
p.u./h |
|
R30 |
\(R_{30}\) |
30 minute ramp rate |
999 |
p.u./h |
|
Rq |
\(R_{q}\) |
ramp rate for reactive power (2 sec timescale) |
999 |
p.u./h |
|
apf |
\(a_{pf}\) |
area participation factor |
0 |
||
pg0 |
\(p_{g0}\) |
active power start point (system base) |
0 |
p.u. |
|
td1 |
\(t_{d1}\) |
minimum ON duration |
1 |
h |
|
td2 |
\(t_{d2}\) |
minimum OFF duration |
0.500 |
h |
|
gentype |
\(g_{type}\) |
generator type |
|||
genfuel |
\(g_{fuel}\) |
generator fuel type |
|||
area |
Retrieved area idx |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
|---|---|---|---|---|
ud |
\(u_d\) |
Algeb |
commitment decision |
bool |
p |
\(p\) |
Algeb |
active power generation |
p.u. |
q |
\(q\) |
Algeb |
reactive power generation |
p.u. |