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: The ACBus 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.0001, 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. See PrimeMovers.
• 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 HydroTurbineavailable.

get_name(value::HydroTurbine) -> String

Get HydroTurbinename.

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

Set HydroTurbineavailable.

get_active_power(value::HydroTurbine) -> Float64

Get HydroTurbineactive_power.

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

Get HydroTurbineactive_power_limits.

get_base_power(value::HydroTurbine) -> Float64

Get HydroTurbinebase_power.

get_bus(value::HydroTurbine) -> ACBus

Get HydroTurbinebus.

get_conversion_factor(value::HydroTurbine) -> Float64

Get HydroTurbineconversion_factor.

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

Get HydroTurbinedynamic_injector.

get_efficiency(value::HydroTurbine) -> Float64

Get HydroTurbineefficiency.

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

Get HydroTurbineext.

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

Get HydroTurbineoperation_cost.

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

Get HydroTurbineoutflow_limits.

get_powerhouse_elevation(value::HydroTurbine) -> Float64

Get HydroTurbinepowerhouse_elevation.

get_prime_mover_type(value::HydroTurbine) -> PrimeMovers

Get HydroTurbineprime_mover_type.

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

Get HydroTurbineramp_limits.

get_rating(value::HydroTurbine) -> Float64

Get HydroTurbinerating.

get_reactive_power(value::HydroTurbine) -> Float64

Get HydroTurbinereactive_power.

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

Get HydroTurbinereactive_power_limits.

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

Get HydroTurbineservices.

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

Get HydroTurbinetime_limits.

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

Get HydroTurbinetravel_time.

get_turbine_type(value::HydroTurbine) -> HydroTurbineType

Get HydroTurbineturbine_type.

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

Set HydroTurbineactive_power.

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

Set HydroTurbineactive_power_limits.

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

Set HydroTurbinebase_power.

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

Set HydroTurbinebus.

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

Set HydroTurbineconversion_factor.

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

Set HydroTurbineefficiency.

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

Set HydroTurbineext.

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

Set HydroTurbineoperation_cost.

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

Set HydroTurbineoutflow_limits.

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

Set HydroTurbinepowerhouse_elevation.

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

Set HydroTurbineprime_mover_type.

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

Set HydroTurbineramp_limits.

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

Set HydroTurbinerating.

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

Set HydroTurbinereactive_power.

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

Set HydroTurbinereactive_power_limits.

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

Set HydroTurbineservices.

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

Set HydroTurbinetime_limits.

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

Set HydroTurbinetravel_time.

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

Set HydroTurbineturbine_type.