ShiftablePowerLoad
PowerSystems.ShiftablePowerLoad
— Typemutable struct ShiftablePowerLoad <: ControllableLoad
name::String
available::Bool
bus::ACBus
active_power::Float64
upper_bound_active_power::Float64
lower_bound_active_power::Float64
reactive_power::Float64
max_active_power::Float64
max_reactive_power::Float64
base_power::Float64
load_balance_time_horizon::Int
operation_cost::Union{LoadCost, MarketBidCost}
services::Vector{Service}
ext::Dict{String, Any}
internal::InfrastructureSystemsInternal
end
A static power load that can be partially or completed shifted to later time periods.
These loads are used to model demand response. This load has a target demand profile (set by a max_active_power
time series for an operational simulation). Load in the profile can be shifted to later time periods to aid in satisfying other system needs; however, any shifted load must be served within a designated time horizon (e.g., 24 hours), which is set by load_balance_time_horizon
.
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
andACBus
) can have the same nameavailable::Bool
: Indicator of whether the component is connected and online (true
) or disconnected, offline, or down (false
). Unavailable components are excluded during simulationsbus::ACBus
: Bus that this component is connected toactive_power::Float64
: Initial steady state active power demand (MW)upper_bound_active_power::Float64
: Initial upper bound on the active power load (MW), validation range:>= active_power
, validation range:(active_power, nothing)
lower_bound_active_power::Float64
: Initial lower bound on the active power load (MW), validation range:<= active_power
, validation range:(nothing, active_power)
reactive_power::Float64
: Initial steady state reactive power demand (MVAR)max_active_power::Float64
: Maximum active power (MW) that this load can demandmax_reactive_power::Float64
: Maximum reactive power (MVAR) that this load can demandbase_power::Float64
: Base power (MVA) for per unitization, validation range:(0, nothing)
load_balance_time_horizon::Int
: Number of time periods over which load must be balanced, validation range:(1, nothing)
operation_cost::Union{LoadCost, MarketBidCost}
:OperationalCost
of interrupting loadservices::Vector{Service}
: (default:Device[]
) Services that this device contributes toext::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
InfrastructureSystems.get_name
— Methodget_name(value::ShiftablePowerLoad) -> String
Get ShiftablePowerLoad
name
.
PowerSystems.get_active_power
— Methodget_active_power(value::ShiftablePowerLoad) -> Any
Get ShiftablePowerLoad
active_power
.
PowerSystems.get_available
— Methodget_available(value::ShiftablePowerLoad) -> Bool
Get ShiftablePowerLoad
available
.
PowerSystems.get_base_power
— Methodget_base_power(value::ShiftablePowerLoad) -> Float64
Get ShiftablePowerLoad
base_power
.
PowerSystems.get_bus
— Methodget_bus(value::ShiftablePowerLoad) -> ACBus
Get ShiftablePowerLoad
bus
.
PowerSystems.get_ext
— Methodget_ext(value::ShiftablePowerLoad) -> Dict{String, Any}
Get ShiftablePowerLoad
ext
.
PowerSystems.get_load_balance_time_horizon
— Methodget_load_balance_time_horizon(
value::ShiftablePowerLoad
) -> Int64
Get ShiftablePowerLoad
load_balance_time_horizon
.
PowerSystems.get_lower_bound_active_power
— Methodget_lower_bound_active_power(
value::ShiftablePowerLoad
) -> Any
Get ShiftablePowerLoad
lower_bound_active_power
.
PowerSystems.get_max_active_power
— Methodget_max_active_power(value::ShiftablePowerLoad) -> Any
Get ShiftablePowerLoad
max_active_power
.
PowerSystems.get_max_reactive_power
— Methodget_max_reactive_power(value::ShiftablePowerLoad) -> Any
Get ShiftablePowerLoad
max_reactive_power
.
PowerSystems.get_operation_cost
— Methodget_operation_cost(
value::ShiftablePowerLoad
) -> Union{LoadCost, MarketBidCost}
Get ShiftablePowerLoad
operation_cost
.
PowerSystems.get_reactive_power
— Methodget_reactive_power(value::ShiftablePowerLoad) -> Any
Get ShiftablePowerLoad
reactive_power
.
PowerSystems.get_services
— Methodget_services(value::ShiftablePowerLoad) -> Vector{Service}
Get ShiftablePowerLoad
services
.
PowerSystems.get_upper_bound_active_power
— Methodget_upper_bound_active_power(
value::ShiftablePowerLoad
) -> Any
Get ShiftablePowerLoad
upper_bound_active_power
.
PowerSystems.set_active_power!
— Methodset_active_power!(value::ShiftablePowerLoad, val) -> Any
Set ShiftablePowerLoad
active_power
.
PowerSystems.set_available!
— Methodset_available!(value::ShiftablePowerLoad, val) -> Any
Set ShiftablePowerLoad
available
.
PowerSystems.set_base_power!
— Methodset_base_power!(value::ShiftablePowerLoad, val) -> Any
Set ShiftablePowerLoad
base_power
.
PowerSystems.set_bus!
— Methodset_bus!(value::ShiftablePowerLoad, val) -> Any
Set ShiftablePowerLoad
bus
.
PowerSystems.set_ext!
— Methodset_ext!(value::ShiftablePowerLoad, val) -> Any
Set ShiftablePowerLoad
ext
.
PowerSystems.set_load_balance_time_horizon!
— Methodset_load_balance_time_horizon!(
value::ShiftablePowerLoad,
val
) -> Any
Set ShiftablePowerLoad
load_balance_time_horizon
.
PowerSystems.set_lower_bound_active_power!
— Methodset_lower_bound_active_power!(
value::ShiftablePowerLoad,
val
) -> Any
Set ShiftablePowerLoad
lower_bound_active_power
.
PowerSystems.set_max_active_power!
— Methodset_max_active_power!(value::ShiftablePowerLoad, val) -> Any
Set ShiftablePowerLoad
max_active_power
.
PowerSystems.set_max_reactive_power!
— Methodset_max_reactive_power!(
value::ShiftablePowerLoad,
val
) -> Any
Set ShiftablePowerLoad
max_reactive_power
.
PowerSystems.set_operation_cost!
— Methodset_operation_cost!(value::ShiftablePowerLoad, val) -> Any
Set ShiftablePowerLoad
operation_cost
.
PowerSystems.set_reactive_power!
— Methodset_reactive_power!(value::ShiftablePowerLoad, val) -> Any
Set ShiftablePowerLoad
reactive_power
.
PowerSystems.set_services!
— Methodset_services!(value::ShiftablePowerLoad, val) -> Any
Set ShiftablePowerLoad
services
.
PowerSystems.set_upper_bound_active_power!
— Methodset_upper_bound_active_power!(
value::ShiftablePowerLoad,
val
) -> Any
Set ShiftablePowerLoad
upper_bound_active_power
.