RenewableDispatch

Package: PowerOperationsOpenAPIModels · Source: Operations/StaticInjection/RenewableDispatch.json

A renewable (e.g., wind or solar) generator whose output can be curtailed to satisfy power system constraints.

These generators can also participate in reserves markets, including upwards reserves by proactively curtailing some available power (based on its max_active_power time series). Example uses include: a utility-scale wind or solar generator whose PPA allows curtailment. For non-curtailable or must-take renewables, see RenewableNonDispatch.

Renewable generators do not have a max_active_power parameter, which is instead calculated when calling get_max_active_power().

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.
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, used in some production cost modeling simulations. To set the reactive power in a load flow, use power_factor. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu .
rating	number	yes	MVA / pu (by power_units)	Maximum AC side output power rating of the unit. Not to be confused with base_power. Units: per power_units — NATURAL_UNITS: MVA, COMPONENT_BASE: pu .
prime_mover_type	string (PrimeMovers)	yes	—	Prime mover technology according to EIA 923.
reactive_power_limits	MinMax	—	MVAr / pu (by power_units)	Minimum and maximum reactive power limits, used in some production cost model simulations and in power flow if the unit is connected to a PV bus. Set to null if not applicable. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu .
power_factor	number	yes	1	Power factor [0, 1] set-point, used in some production cost modeling and in load flow if the unit is connected to a PQ bus. Units: 1.
operation_cost	RenewableGenerationCost or MarketBidCost or MarketBidTimeSeriesCost or ImportExportTimeSeriesCost	yes	—	Operating cost of generation. or MarketBidCost
base_power	number	yes	MVA	Base power of the unit for per unitization. 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.
dynamic_injector	integer or null	—	—	ID of the corresponding dynamic injection device, if any.