StandardLoad

mutable struct StandardLoad <: StaticLoad
    name::String
    available::Bool
    bus::ACBus
    base_power::Float64
    constant_active_power::Float64
    constant_reactive_power::Float64
    impedance_active_power::Float64
    impedance_reactive_power::Float64
    current_active_power::Float64
    current_reactive_power::Float64
    max_constant_active_power::Float64
    max_constant_reactive_power::Float64
    max_impedance_active_power::Float64
    max_impedance_reactive_power::Float64
    max_current_active_power::Float64
    max_current_reactive_power::Float64
    services::Vector{Service}
    dynamic_injector::Union{Nothing, DynamicInjection}
    ext::Dict{String, Any}
    internal::InfrastructureSystemsInternal
end

A voltage-dependent ZIP load, most commonly used for dynamics modeling.

A StandardLoad breaks the ZIP into three pieces: Z (constant impedance), I (constant current), and P (constant power), according to P = P_P * V^0 + P_I * V^1 + P_Z * V^2 for active power and Q = Q_P * V^0 + Q_I * V^1 + Q_Z * V^2 for reactive power. (Voltage V is in per unit.)

For an alternative exponential formulation of the ZIP model, see ExponentialLoad. For a simpler load model with no voltage dependency, see PowerLoad

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
• base_power::Float64: Base power of the load (MVA) for per unitization, validation range: (0, nothing)
• constant_active_power::Float64: (default: 0.0) Constant active power demand in MW (P_P)
• constant_reactive_power::Float64: (default: 0.0) Constant reactive power demand in MVAR (Q_P)
• impedance_active_power::Float64: (default: 0.0) Active power coefficient in MW for constant impedance load (P_Z)
• impedance_reactive_power::Float64: (default: 0.0) Reactive power coefficient in MVAR for constant impedance load (Q_Z)
• current_active_power::Float64: (default: 0.0) Active power coefficient in MW for constant current load (P_I)
• current_reactive_power::Float64: (default: 0.0) Reactive power coefficient in MVAR for constant current load (Q_I)
• max_constant_active_power::Float64: (default: 0.0) Maximum active power (MW) drawn by constant power load
• max_constant_reactive_power::Float64: (default: 0.0) Maximum reactive power (MVAR) drawn by constant power load
• max_impedance_active_power::Float64: (default: 0.0) Maximum active power (MW) drawn by constant impedance load
• max_impedance_reactive_power::Float64: (default: 0.0) Maximum reactive power (MVAR) drawn by constant impedance load
• max_current_active_power::Float64: (default: 0.0) Maximum active power (MW) drawn by constant current load
• max_current_reactive_power::Float64: (default: 0.0) Maximum reactive power (MVAR) drawn by constant current load
• 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, such as latitude and longitude.
• internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference

get_name(value::StandardLoad) -> String

Get StandardLoad name.

get_available(value::StandardLoad) -> Bool

Get StandardLoad available.

get_base_power(value::StandardLoad) -> Float64

Get StandardLoad base_power.

get_bus(value::StandardLoad) -> ACBus

Get StandardLoad bus.

get_constant_active_power(value::StandardLoad) -> Any

Get StandardLoad constant_active_power.

get_constant_reactive_power(value::StandardLoad) -> Any

Get StandardLoad constant_reactive_power.

get_current_active_power(value::StandardLoad) -> Any

Get StandardLoad current_active_power.

get_current_reactive_power(value::StandardLoad) -> Any

Get StandardLoad current_reactive_power.

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

Get StandardLoad dynamic_injector.

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

Get StandardLoad ext.

get_impedance_active_power(value::StandardLoad) -> Any

Get StandardLoad impedance_active_power.

get_impedance_reactive_power(value::StandardLoad) -> Any

Get StandardLoad impedance_reactive_power.

get_max_constant_active_power(value::StandardLoad) -> Any

Get StandardLoad max_constant_active_power.

get_max_constant_reactive_power(value::StandardLoad) -> Any

Get StandardLoad max_constant_reactive_power.

get_max_current_active_power(value::StandardLoad) -> Any

Get StandardLoad max_current_active_power.

get_max_current_reactive_power(value::StandardLoad) -> Any

Get StandardLoad max_current_reactive_power.

get_max_impedance_active_power(value::StandardLoad) -> Any

Get StandardLoad max_impedance_active_power.

get_max_impedance_reactive_power(value::StandardLoad) -> Any

Get StandardLoad max_impedance_reactive_power.

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

Get StandardLoad services.

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

Set StandardLoad available.

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

Set StandardLoad base_power.

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

Set StandardLoad bus.

set_constant_active_power!(value::StandardLoad, val) -> Any

Set StandardLoad constant_active_power.

set_constant_reactive_power!(
    value::StandardLoad,
    val
) -> Any

Set StandardLoad constant_reactive_power.

set_current_active_power!(value::StandardLoad, val) -> Any

Set StandardLoad current_active_power.

set_current_reactive_power!(value::StandardLoad, val) -> Any

Set StandardLoad current_reactive_power.

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

Set StandardLoad ext.

set_impedance_active_power!(value::StandardLoad, val) -> Any

Set StandardLoad impedance_active_power.

set_impedance_reactive_power!(
    value::StandardLoad,
    val
) -> Any

Set StandardLoad impedance_reactive_power.

set_max_constant_active_power!(
    value::StandardLoad,
    val
) -> Any

Set StandardLoad max_constant_active_power.

set_max_constant_reactive_power!(
    value::StandardLoad,
    val
) -> Any

Set StandardLoad max_constant_reactive_power.

set_max_current_active_power!(
    value::StandardLoad,
    val
) -> Any

Set StandardLoad max_current_active_power.

set_max_current_reactive_power!(
    value::StandardLoad,
    val
) -> Any

Set StandardLoad max_current_reactive_power.

set_max_impedance_active_power!(
    value::StandardLoad,
    val
) -> Any

Set StandardLoad max_impedance_active_power.

set_max_impedance_reactive_power!(
    value::StandardLoad,
    val
) -> Any

Set StandardLoad max_impedance_reactive_power.

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

Set StandardLoad services.