HydroTurbine

mutable struct HydroTurbine <: HydroUnit
    name::String
    available::Bool
    bus::ACBus
    active_power::Float64
    reactive_power::Float64
    rating::Float64
    active_power_limits::MinMax
    reactive_power_limits::Union{Nothing, MinMax}
    base_power::Float64
    operation_cost::Union{HydroGenerationCost, MarketBidCost}
    powerhouse_elevation::Float64
    ramp_limits::Union{Nothing, UpDown}
    time_limits::Union{Nothing, UpDown}
    outflow_limits::Union{Nothing, MinMax}
    efficiency::Float64
    turbine_type::HydroTurbineType
    conversion_factor::Float64
    prime_mover_type::PrimeMovers
    travel_time::Union{Nothing, Float64}
    services::Vector{Service}
    dynamic_injector::Union{Nothing, DynamicInjection}
    ext::Dict{String, Any}
    internal::InfrastructureSystemsInternal
end

A hydropower generator that must have a HydroReservoir attached, suitable for modeling independent turbines and 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 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 AC side output power rating of the unit. Stored in per unit of the device and not to be confused with base_power, validation range: (0, nothing)
• active_power_limits::MinMax: Minimum and maximum stable active power levels (MW), validation range: (0, nothing)
• reactive_power_limits::Union{Nothing, MinMax}: Minimum and maximum reactive power limits. Set to Nothing if not applicable
• 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
• powerhouse_elevation::Float64: (default: 0.0) 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}: (default: nothing) ramp up and ramp down limits in MW/min, validation range: (0, nothing)
• time_limits::Union{Nothing, UpDown}: (default: nothing) Minimum up and Minimum down time limits in hours, validation range: (0, nothing)
• outflow_limits::Union{Nothing, MinMax}: (default: nothing) Turbine outflow limits in m3/s. Set to Nothing if not applicable
• efficiency::Float64: (default: 1.0) Turbine efficiency [0, 1.0], validation range: (0, 1)
• turbine_type::HydroTurbineType: (default: HydroTurbineType.UNKNOWN) Type of the turbine
• conversion_factor::Float64: (default: 1.0) Conversion factor from flow/volume to energy: m^3 -> p.u-hr
• prime_mover_type::PrimeMovers: (default: PrimeMovers.HY) Prime mover technology according to EIA 923. Options are listed here
• travel_time::Union{Nothing, Float64}: (default: nothing) Downstream (from reservoir into turbine) travel time in hours.
• 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_available(value::HydroTurbine) -> Bool

Get HydroTurbine available.

get_name(value::HydroTurbine) -> String

Get HydroTurbine name.

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

Set HydroTurbine available.

get_active_power(value::HydroTurbine) -> Float64

Get HydroTurbine active_power.

get_active_power_limits(
    value::HydroTurbine
) -> @NamedTuple{min::Float64, max::Float64}

Get HydroTurbine active_power_limits.

get_base_power(value::HydroTurbine) -> Float64

Get HydroTurbine base_power.

get_bus(value::HydroTurbine) -> ACBus

Get HydroTurbine bus.

get_conversion_factor(value::HydroTurbine) -> Float64

Get HydroTurbine conversion_factor.

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

Get HydroTurbine dynamic_injector.

get_efficiency(value::HydroTurbine) -> Float64

Get HydroTurbine efficiency.

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

Get HydroTurbine ext.

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

Get HydroTurbine operation_cost.

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

Get HydroTurbine outflow_limits.

get_powerhouse_elevation(value::HydroTurbine) -> Float64

Get HydroTurbine powerhouse_elevation.

get_prime_mover_type(value::HydroTurbine) -> PrimeMovers

Get HydroTurbine prime_mover_type.

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

Get HydroTurbine ramp_limits.

get_rating(value::HydroTurbine) -> Float64

Get HydroTurbine rating.

get_reactive_power(value::HydroTurbine) -> Float64

Get HydroTurbine reactive_power.

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

Get HydroTurbine reactive_power_limits.

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

Get HydroTurbine services.

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

Get HydroTurbine time_limits.

get_travel_time(
    value::HydroTurbine
) -> Union{Nothing, Float64}

Get HydroTurbine travel_time.

get_turbine_type(value::HydroTurbine) -> HydroTurbineType

Get HydroTurbine turbine_type.

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

Set HydroTurbine active_power.

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

Set HydroTurbine active_power_limits.

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

Set HydroTurbine base_power.

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

Set HydroTurbine bus.

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

Set HydroTurbine conversion_factor.

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

Set HydroTurbine efficiency.

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

Set HydroTurbine ext.

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

Set HydroTurbine operation_cost.

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

Set HydroTurbine outflow_limits.

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

Set HydroTurbine powerhouse_elevation.

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

Set HydroTurbine prime_mover_type.

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

Set HydroTurbine ramp_limits.

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

Set HydroTurbine rating.

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

Set HydroTurbine reactive_power.

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

Set HydroTurbine reactive_power_limits.

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

Set HydroTurbine services.

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

Set HydroTurbine time_limits.

set_travel_time!(value::HydroTurbine, val) -> Any

Set HydroTurbine travel_time.

set_turbine_type!(value::HydroTurbine, val) -> Any

Set HydroTurbine turbine_type.