HydroPumpTurbine

mutable struct HydroPumpTurbine <: HydroGen
    name::String
    available::Bool
    bus::ACBus
    active_power::Float64
    reactive_power::Float64
    rating::Float64
    active_power_limits::MinMax
    reactive_power_limits::Union{Nothing, MinMax}
    active_power_limits_pump::MinMax
    outflow_limits::Union{Nothing, MinMax}
    head_reservoir::HydroReservoir
    tail_reservoir::HydroReservoir
    powerhouse_elevation::Float64
    ramp_limits::Union{Nothing, UpDown}
    time_limits::Union{Nothing, UpDown}
    base_power::Float64
    operation_cost::Union{HydroGenerationCost, MarketBidCost}
    active_power_pump::Float64
    efficiency::TurbinePump
    transition_time::TurbinePump
    minimum_time::TurbinePump
    conversion_factor::Float64
    must_run::Bool
    prime_mover_type::PrimeMovers
    services::Vector{Service}
    dynamic_injector::Union{Nothing, DynamicInjection}
    ext::Dict{String, Any}
    internal::InfrastructureSystemsInternal
end

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

Arguments

• name::String: 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::Bool: Indicator of whether the component is connected and online (true) or disconnected, offline, or down (false). Unavailable components are excluded during simulations
• bus::ACBus: Bus that this component is connected to
• active_power::Float64: Initial active power set point of the turbine unit in MW. 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
• reactive_power::Float64: Initial reactive power set point of the unit (MVAR), validation range: reactive_power_limits
• rating::Float64: Maximum output power rating of the unit (MVA), validation range: (0, nothing)
• active_power_limits::MinMax: Minimum and maximum stable active power levels (MW) for the turbine, validation range: (0, nothing)
• reactive_power_limits::Union{Nothing, MinMax}: Minimum and maximum reactive power limits. Set to Nothing if not applicable
• active_power_limits_pump::MinMax: Minimum and maximum stable active power levels (MW) for the pump, validation range: (0, nothing)
• outflow_limits::Union{Nothing, MinMax}: Turbine/Pump outflow limits in m3/s. Set to Nothing if not applicable
• head_reservoir::HydroReservoir: Head reservoir that this component is connected to
• tail_reservoir::HydroReservoir: Tail reservoir that this component is connected to
• powerhouse_elevation::Float64: Height level in meters above the sea level of the powerhouse on which the turbine is installed., validation range: (0, nothing)
• ramp_limits::Union{Nothing, UpDown}: ramp up and ramp down limits in MW/min, validation range: (0, nothing)
• time_limits::Union{Nothing, UpDown}: Minimum up and Minimum down time limits in hours, validation range: (0, nothing)
• base_power::Float64: Base power of the unit (MVA) for per unitization, validation range: (0, nothing)
• operation_cost::Union{HydroGenerationCost, MarketBidCost}: (default: HydroGenerationCost(nothing)) OperationalCost of generation
• active_power_pump::Float64: (default: 0.0) Initial active power set point of the pump unit in MW. 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
• efficiency::TurbinePump: (default: (turbine = 1.0, pump = 1.0)) Turbine/Pump efficiency [0, 1.0]
• transition_time::TurbinePump: (default: (turbine = 0.0, pump = 0.0)) Transition time in hours to switch into the specific mode.
• minimum_time::TurbinePump: (default: (turbine = 0.0, pump = 0.0)) Minimum operating time in hours for the specific mode.
• conversion_factor::Float64: (default: 1.0) Conversion factor from flow/volume to energy: m^3 -> p.u-hr
• must_run::Bool: (default: false) Set to true if the unit is must run
• prime_mover_type::PrimeMovers: (default: PrimeMovers.PS) Prime mover technology according to EIA 923. Options are listed here
• services::Vector{Service}: (default: Device[]) Services that this device contributes to
• dynamic_injector::Union{Nothing, DynamicInjection}: (default: nothing) corresponding dynamic injection device
• ext::Dict{String, Any}: (default: Dict{String, Any}()) An extra dictionary for users to add metadata that are not used in simulation.
• internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference

get_name(value::HydroPumpTurbine) -> String

Get HydroPumpTurbine name.

get_active_power(value::HydroPumpTurbine) -> Any

Get HydroPumpTurbine active_power.

get_active_power_limits(
    value::HydroPumpTurbine
) -> NamedTuple{(:min, :max), <:Tuple{Any, Any}}

Get HydroPumpTurbine active_power_limits.

get_active_power_limits_pump(
    value::HydroPumpTurbine
) -> NamedTuple{(:min, :max), <:Tuple{Any, Any}}

Get HydroPumpTurbine active_power_limits_pump.

get_active_power_pump(value::HydroPumpTurbine) -> Any

Get HydroPumpTurbine active_power_pump.

get_available(value::HydroPumpTurbine) -> Bool

Get HydroPumpTurbine available.

get_base_power(value::HydroPumpTurbine) -> Float64

Get HydroPumpTurbine base_power.

get_bus(value::HydroPumpTurbine) -> ACBus

Get HydroPumpTurbine bus.

get_conversion_factor(value::HydroPumpTurbine) -> Float64

Get HydroPumpTurbine conversion_factor.

get_dynamic_injector(
    value::HydroPumpTurbine
) -> Union{Nothing, DynamicInjection}

Get HydroPumpTurbine dynamic_injector.

get_efficiency(
    value::HydroPumpTurbine
) -> @NamedTuple{turbine::Float64, pump::Float64}

Get HydroPumpTurbine efficiency.

get_ext(value::HydroPumpTurbine) -> Dict{String, Any}

Get HydroPumpTurbine ext.

get_head_reservoir(
    value::HydroPumpTurbine
) -> HydroReservoir

Get HydroPumpTurbine head_reservoir.

get_minimum_time(
    value::HydroPumpTurbine
) -> @NamedTuple{turbine::Float64, pump::Float64}

Get HydroPumpTurbine minimum_time.

get_must_run(value::HydroPumpTurbine) -> Bool

Get HydroPumpTurbine must_run.

get_operation_cost(
    value::HydroPumpTurbine
) -> Union{HydroGenerationCost, MarketBidCost}

Get HydroPumpTurbine operation_cost.

get_outflow_limits(
    value::HydroPumpTurbine
) -> Union{Nothing, @NamedTuple{min::Float64, max::Float64}}

Get HydroPumpTurbine outflow_limits.

get_powerhouse_elevation(value::HydroPumpTurbine) -> Float64

Get HydroPumpTurbine powerhouse_elevation.

get_prime_mover_type(value::HydroPumpTurbine) -> PrimeMovers

Get HydroPumpTurbine prime_mover_type.

get_ramp_limits(
    value::HydroPumpTurbine
) -> Union{Nothing, NamedTuple{(:up, :down), <:Tuple{Any, Any}}}

Get HydroPumpTurbine ramp_limits.

get_rating(value::HydroPumpTurbine) -> Any

Get HydroPumpTurbine rating.

get_reactive_power(value::HydroPumpTurbine) -> Any

Get HydroPumpTurbine reactive_power.

get_reactive_power_limits(
    value::HydroPumpTurbine
) -> Union{Nothing, NamedTuple{(:min, :max), <:Tuple{Any, Any}}}

Get HydroPumpTurbine reactive_power_limits.

get_services(value::HydroPumpTurbine) -> Vector{Service}

Get HydroPumpTurbine services.

get_tail_reservoir(
    value::HydroPumpTurbine
) -> HydroReservoir

Get HydroPumpTurbine tail_reservoir.

get_time_limits(
    value::HydroPumpTurbine
) -> Union{Nothing, @NamedTuple{up::Float64, down::Float64}}

Get HydroPumpTurbine time_limits.

get_transition_time(
    value::HydroPumpTurbine
) -> @NamedTuple{turbine::Float64, pump::Float64}

Get HydroPumpTurbine transition_time.

set_active_power!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine active_power.

set_active_power_limits!(
    value::HydroPumpTurbine,
    val
) -> Any

Set HydroPumpTurbine active_power_limits.

set_active_power_limits_pump!(
    value::HydroPumpTurbine,
    val
) -> Any

Set HydroPumpTurbine active_power_limits_pump.

set_active_power_pump!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine active_power_pump.

set_available!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine available.

set_base_power!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine base_power.

set_bus!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine bus.

set_conversion_factor!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine conversion_factor.

set_efficiency!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine efficiency.

set_ext!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine ext.

set_head_reservoir!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine head_reservoir.

set_minimum_time!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine minimum_time.

set_must_run!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine must_run.

set_operation_cost!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine operation_cost.

set_outflow_limits!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine outflow_limits.

set_powerhouse_elevation!(
    value::HydroPumpTurbine,
    val
) -> Any

Set HydroPumpTurbine powerhouse_elevation.

set_prime_mover_type!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine prime_mover_type.

set_ramp_limits!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine ramp_limits.

set_rating!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine rating.

set_reactive_power!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine reactive_power.

set_reactive_power_limits!(
    value::HydroPumpTurbine,
    val
) -> Any

Set HydroPumpTurbine reactive_power_limits.

set_services!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine services.

set_tail_reservoir!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine tail_reservoir.

set_time_limits!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine time_limits.

set_transition_time!(value::HydroPumpTurbine, val) -> Any

Set HydroPumpTurbine transition_time.