HydroPumpTurbine

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

A hydropower pumped turbine that needs to have two HydroReservoirs attached, suitable for modeling independent pumped hydro with reservoirs.

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 turbine 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 .
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 .
active_power_limits	MinMax	yes	MW / pu (by power_units)	Minimum and maximum stable active power levels for the turbine. 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. in psy5 a required param with an option to be nothing Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu .
active_power_limits_pump	MinMax	yes	MW / pu (by power_units)	Minimum and maximum stable active power levels for the pump. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu .
outflow_limits	MinMax	—	m3/s	Turbine/Pump outflow limits. Set to null if not applicable. in psy5 a required param with an option to be nothing Units: m3/s.
powerhouse_elevation	number	yes	m	Height level above the sea level of the powerhouse on which the turbine is installed. Units: m.
ramp_limits	UpDown	—	MW/min / pu/min (by power_units)	Ramp up and ramp down limits. in psy5 a required param with an option to be nothing Units: per power_units — NATURAL_UNITS: MW/min, COMPONENT_BASE: pu/min .
time_limits	UpDown	—	min	Minimum up and minimum down time limits. in psy5 a required param with an option to be nothing Units: min.
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.
operating_mode	string	—	—	Which mode the pumped-storage unit is operating in at the start of a simulation: pumping, generating, or idle.
status	string (OperationalStates)	—	—	Operating state of the unit at the start of a simulation.
time_at_status	number	—	min	Time the generator has been in its current status. default is the INFINITE_TIME sentinel (1e4 hours, 600000 minutes). Units: min.
operation_cost	HydroGenerationCost or MarketBidCost or MarketBidTimeSeriesCost or ImportExportTimeSeriesCost	yes	—	Operating cost of generation. or MarketBidCost; default PSY.HydroGenerationCost(nothing)
active_power_pump	number	—	MW / pu (by power_units)	Initial active power set point of the pump 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 .
efficiency	TurbinePump	—	—	Turbine/Pump efficiency [0, 1.0].
transition_time	TurbinePump	—	min	Transition time to switch into the specific mode. Units: min.
minimum_time	TurbinePump	—	min	Minimum operating time for the specific mode. Units: min.
travel_time	number or null	—	min	Downstream (from reservoir into turbine) travel time. Set to null if not applicable. Units: min.
conversion_factor	number	—	1	Conversion factor from flow/volume to energy: m^3 -> p.u-hr. Units: 1.
commitment_mode	string (CommitmentModes)	—	—	Commitment mode of the unit.
prime_mover_type	string (PrimeMovers)	—	—	Prime mover technology according to EIA 923.
dynamic_injector	integer or null	—	—	ID of the corresponding dynamic injection device, if any.