HybridSystem
Package: PowerOperationsOpenAPIModels · Source: Operations/StaticInjection/HybridSystem.json
A hybrid system co-locating a thermal unit, electric load, storage, and/or renewable unit behind a single grid interconnection.
Properties
| Property | Type | Required | Unit | Description |
|---|---|---|---|---|
id | integer | yes | — | Unique integer identifier for this component. |
name | string | yes | — | Name of the component. Components of the same type (e.g., PowerLoad) must have unique names, but components of different types (e.g., PowerLoad and ACBus) can have the same name. |
available | boolean | yes | — | Indicator of whether the component is connected and online (true) or disconnected, offline, or down (false). Unavailable components are excluded during simulations. |
status | string (OperationalStates) | yes | — | Operating state of the unit at the start of a simulation. |
bus | integer | yes | — | ID of the bus that this component is connected to. |
active_power | number | yes | MW / pu (by power_units) | Initial active power set point of the unit. For power flow, this is the steady state operating point of the system. For production cost modeling, this may or may not be used as the initial starting point for the solver, depending on the solver used. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu . |
reactive_power | number | yes | MVAr / pu (by power_units) | Initial reactive power set point of the unit. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu . |
base_power | number | yes | MVA | Base power of the unit for per unitization, which is commonly the same as interconnection_rating. Units: MVA. |
power_units | string (UnitSystem) | yes | — | Unit basis for this component’s power-family fields (active/reactive/apparent power, ratings, limits, ramp rates). COMPONENT_BASE: per unit on this component’s own base_power. NATURAL_UNITS: the field’s physical unit. |
operation_cost | MarketBidCost | yes | — | MarketBidCost of operating the hybrid system. |
thermal_unit | integer or null | — | — | ID of a thermal generator with supertype ThermalGen, if any. |
electric_load | integer or null | — | — | ID of a load with supertype ElectricLoad, if any. |
storage | integer or null | — | — | ID of an energy storage system with supertype Storage, if any. |
renewable_unit | integer or null | — | — | ID of a renewable generator with supertype RenewableGen, if any. |
interconnection_impedance | ComplexNumber | — | pu | Impedance between the hybrid system and the grid interconnection. Per-unit on base_power. Units: pu. |
interconnection_rating | number or null | — | MVA / pu (by power_units) | Maximum rating of the hybrid system’s interconnection with the transmission network. Set to null if not applicable. Units: per power_units — NATURAL_UNITS: MVA, COMPONENT_BASE: pu . |
input_active_power_limits | MinMax | — | MW / pu (by power_units) | Minimum and maximum stable input active power levels. Set to null if not applicable. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu . |
output_active_power_limits | MinMax | — | MW / pu (by power_units) | Minimum and maximum stable output active power levels. Set to null if not applicable. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu . |
reactive_power_limits | MinMax | — | MVAr / pu (by power_units) | Minimum and maximum reactive power limits. Set to null if not applicable. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu . |
interconnection_efficiency | InOut | — | — | Efficiency [0, 1.0] at the grid interconnection to model losses in and out of the common DC-side conversion. Set to null if not applicable. |
dynamic_injector | integer or null | — | — | ID of the corresponding dynamic injection device, if any. |