.. _StaticGen: ================================================================================ 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 Available models: Slack_, PV_ .. _Slack: -------------------------------------------------------------------------------- Slack -------------------------------------------------------------------------------- Slack generator model. Parameters ---------- +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Name | Symbol | Description | Default | Unit | Properties | +==========+===================+======================================================================+=========+==========+============+ | idx | | unique device idx | | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | u | :math:`u` | connection status | 1 | *bool* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | name | | device name | | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Sn | :math:`S_n` | Power rating | 100 | | non_zero | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Vn | :math:`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 | :math:`p_0` | active power set point in system base | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | q0 | :math:`q_0` | reactive power set point in system base | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | pmax | :math:`p_{max}` | maximum active power in system base | 999 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | pmin | :math:`p_{min}` | minimum active power in system base | -1 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | qmax | :math:`q_{max}` | maximim reactive power in system base | 999 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | qmin | :math:`q_{min}` | minimum reactive power in system base | -999 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | v0 | :math:`v_0` | voltage set point | 1 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | vmax | :math:`v_{max}` | maximum voltage voltage | 1.400 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | vmin | :math:`v_{min}` | minimum allowed voltage | 0.600 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | ra | :math:`r_a` | armature resistance | 0 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | xs | :math:`x_s` | armature reactance | 0.300 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | wmod | :math:`w_{mod}` | Machine ctrl. mode [PSS/E] | 0 | *int* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | a0 | :math:`\theta_0` | reference angle set point | 0 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | ctrl | :math:`c_{trl}` | generator controllability | 1 | *bool* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | uf | :math:`u_{f}` | enforced on/off status; 0 unenforced, 1 enforced on, -1 enforced off | 0 | *int* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Pc1 | :math:`P_{c1}` | lower real power output of PQ capability curve | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Pc2 | :math:`P_{c2}` | upper real power output of PQ capability curve | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Qc1min | :math:`Q_{c1min}` | minimum reactive power output at Pc1 | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Qc1max | :math:`Q_{c1max}` | maximum reactive power output at Pc1 | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Qc2min | :math:`Q_{c2min}` | minimum reactive power output at Pc2 | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Qc2max | :math:`Q_{c2max}` | maximum reactive power output at Pc2 | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Ragc | :math:`R_{agc}` | ramp rate for load following/AGC | 999 | *p.u./h* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | R10 | :math:`R_{10}` | ramp rate for 10 minute reserves | 999 | *p.u./h* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | R30 | :math:`R_{30}` | 30 minute ramp rate | 999 | *p.u./h* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Rq | :math:`R_{q}` | ramp rate for reactive power (2 sec timescale) | 999 | *p.u./h* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | apf | :math:`a_{pf}` | area participation factor | 0 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | pg0 | :math:`p_{g0}` | active power start point (system base) | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | td1 | :math:`t_{d1}` | minimum ON duration | 1 | *h* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | td2 | :math:`t_{d2}` | minimum OFF duration | 0.500 | *h* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | gentype | :math:`g_{type}` | generator type | | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | genfuel | :math:`g_{fuel}` | generator fuel type | | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | area | | Retrieved area idx | | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ Variables --------- +------+-------------+-------+---------------------------+--------+ | Name | Symbol | Type | Description | Unit | +======+=============+=======+===========================+========+ | ud | :math:`u_d` | Algeb | commitment decision | *bool* | +------+-------------+-------+---------------------------+--------+ | p | :math:`p` | Algeb | active power generation | *p.u.* | +------+-------------+-------+---------------------------+--------+ | q | :math:`q` | Algeb | reactive power generation | *p.u.* | +------+-------------+-------+---------------------------+--------+ .. _PV: -------------------------------------------------------------------------------- PV -------------------------------------------------------------------------------- PV generator model. TODO: implement type conversion in config Parameters ---------- +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Name | Symbol | Description | Default | Unit | Properties | +==========+===================+======================================================================+=========+==========+============+ | idx | | unique device idx | | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | u | :math:`u` | connection status | 1 | *bool* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | name | | device name | | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Sn | :math:`S_n` | Power rating | 100 | | non_zero | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Vn | :math:`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 | :math:`p_0` | active power set point in system base | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | q0 | :math:`q_0` | reactive power set point in system base | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | pmax | :math:`p_{max}` | maximum active power in system base | 999 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | pmin | :math:`p_{min}` | minimum active power in system base | -1 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | qmax | :math:`q_{max}` | maximim reactive power in system base | 999 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | qmin | :math:`q_{min}` | minimum reactive power in system base | -999 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | v0 | :math:`v_0` | voltage set point | 1 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | vmax | :math:`v_{max}` | maximum voltage voltage | 1.400 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | vmin | :math:`v_{min}` | minimum allowed voltage | 0.600 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | ra | :math:`r_a` | armature resistance | 0 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | xs | :math:`x_s` | armature reactance | 0.300 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | wmod | :math:`w_{mod}` | Machine ctrl. mode [PSS/E] | 0 | *int* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | ctrl | :math:`c_{trl}` | generator controllability | 1 | *bool* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | uf | :math:`u_{f}` | enforced on/off status; 0 unenforced, 1 enforced on, -1 enforced off | 0 | *int* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Pc1 | :math:`P_{c1}` | lower real power output of PQ capability curve | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Pc2 | :math:`P_{c2}` | upper real power output of PQ capability curve | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Qc1min | :math:`Q_{c1min}` | minimum reactive power output at Pc1 | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Qc1max | :math:`Q_{c1max}` | maximum reactive power output at Pc1 | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Qc2min | :math:`Q_{c2min}` | minimum reactive power output at Pc2 | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Qc2max | :math:`Q_{c2max}` | maximum reactive power output at Pc2 | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Ragc | :math:`R_{agc}` | ramp rate for load following/AGC | 999 | *p.u./h* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | R10 | :math:`R_{10}` | ramp rate for 10 minute reserves | 999 | *p.u./h* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | R30 | :math:`R_{30}` | 30 minute ramp rate | 999 | *p.u./h* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | Rq | :math:`R_{q}` | ramp rate for reactive power (2 sec timescale) | 999 | *p.u./h* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | apf | :math:`a_{pf}` | area participation factor | 0 | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | pg0 | :math:`p_{g0}` | active power start point (system base) | 0 | *p.u.* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | td1 | :math:`t_{d1}` | minimum ON duration | 1 | *h* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | td2 | :math:`t_{d2}` | minimum OFF duration | 0.500 | *h* | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | gentype | :math:`g_{type}` | generator type | | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | genfuel | :math:`g_{fuel}` | generator fuel type | | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ | area | | Retrieved area idx | | | | +----------+-------------------+----------------------------------------------------------------------+---------+----------+------------+ Variables --------- +------+-------------+-------+---------------------------+--------+ | Name | Symbol | Type | Description | Unit | +======+=============+=======+===========================+========+ | ud | :math:`u_d` | Algeb | commitment decision | *bool* | +------+-------------+-------+---------------------------+--------+ | p | :math:`p` | Algeb | active power generation | *p.u.* | +------+-------------+-------+---------------------------+--------+ | q | :math:`q` | Algeb | reactive power generation | *p.u.* | +------+-------------+-------+---------------------------+--------+