ExponentialLoad
PowerSystems.ExponentialLoad
— Typemutable struct ExponentialLoad <: StaticLoad
name::String
available::Bool
bus::ACBus
active_power::Float64
reactive_power::Float64
α::Float64
β::Float64
base_power::Float64
max_active_power::Float64
max_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.
An ExponentialLoad
models active power as P = P0 * V^α and reactive power as Q = Q0 * V^β, where the exponents α and β select govern the voltage dependency. For an alternative three-part formulation of the ZIP model, see StandardLoad
. 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
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
: Active power coefficient, P0 (MW)reactive_power::Float64
: Reactive power coefficient, Q0 (MVAR)α::Float64
: Exponent relating voltage dependency for active power. 0 = constant power only, 1 = constant current only, and 2 = constant impedance only, validation range:(0, nothing)
β::Float64
: Exponent relating voltage dependency for reactive power. 0 = constant power only, 1 = constant current only, and 2 = constant impedance only, validation range:(0, nothing)
base_power::Float64
: Base power (MVA) for per unitization, validation range:(0, nothing)
max_active_power::Float64
: Maximum active power (MW) that this load can demandmax_reactive_power::Float64
: Maximum reactive power (MVAR) that this load can demandservices::Vector{Service}
: (default:Device[]
) Services that this device contributes todynamic_injector::Union{Nothing, DynamicInjection}
: (default:nothing
) corresponding dynamic injection deviceext::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
InfrastructureSystems.get_name
— Methodget_name(value::ExponentialLoad) -> String
Get ExponentialLoad
name
.
PowerSystems.get_active_power
— Methodget_active_power(value::ExponentialLoad) -> Any
Get ExponentialLoad
active_power
.
PowerSystems.get_available
— Methodget_available(value::ExponentialLoad) -> Bool
Get ExponentialLoad
available
.
PowerSystems.get_base_power
— Methodget_base_power(value::ExponentialLoad) -> Float64
Get ExponentialLoad
base_power
.
PowerSystems.get_bus
— Methodget_bus(value::ExponentialLoad) -> ACBus
Get ExponentialLoad
bus
.
PowerSystems.get_dynamic_injector
— Methodget_dynamic_injector(
value::ExponentialLoad
) -> Union{Nothing, DynamicInjection}
Get ExponentialLoad
dynamic_injector
.
PowerSystems.get_ext
— Methodget_ext(value::ExponentialLoad) -> Dict{String, Any}
Get ExponentialLoad
ext
.
PowerSystems.get_max_active_power
— Methodget_max_active_power(value::ExponentialLoad) -> Any
Get ExponentialLoad
max_active_power
.
PowerSystems.get_max_reactive_power
— Methodget_max_reactive_power(value::ExponentialLoad) -> Any
Get ExponentialLoad
max_reactive_power
.
PowerSystems.get_reactive_power
— Methodget_reactive_power(value::ExponentialLoad) -> Any
Get ExponentialLoad
reactive_power
.
PowerSystems.get_services
— Methodget_services(value::ExponentialLoad) -> Vector{Service}
Get ExponentialLoad
services
.
PowerSystems.get_α
— Methodget_α(value::ExponentialLoad) -> Float64
Get ExponentialLoad
α
.
PowerSystems.get_β
— Methodget_β(value::ExponentialLoad) -> Float64
Get ExponentialLoad
β
.
PowerSystems.set_active_power!
— Methodset_active_power!(value::ExponentialLoad, val) -> Any
Set ExponentialLoad
active_power
.
PowerSystems.set_available!
— Methodset_available!(value::ExponentialLoad, val) -> Any
Set ExponentialLoad
available
.
PowerSystems.set_base_power!
— Methodset_base_power!(value::ExponentialLoad, val) -> Any
Set ExponentialLoad
base_power
.
PowerSystems.set_bus!
— Methodset_bus!(value::ExponentialLoad, val) -> Any
Set ExponentialLoad
bus
.
PowerSystems.set_ext!
— Methodset_ext!(value::ExponentialLoad, val) -> Any
Set ExponentialLoad
ext
.
PowerSystems.set_max_active_power!
— Methodset_max_active_power!(value::ExponentialLoad, val) -> Any
Set ExponentialLoad
max_active_power
.
PowerSystems.set_max_reactive_power!
— Methodset_max_reactive_power!(value::ExponentialLoad, val) -> Any
Set ExponentialLoad
max_reactive_power
.
PowerSystems.set_reactive_power!
— Methodset_reactive_power!(value::ExponentialLoad, val) -> Any
Set ExponentialLoad
reactive_power
.
PowerSystems.set_services!
— Methodset_services!(value::ExponentialLoad, val) -> Any
Set ExponentialLoad
services
.
PowerSystems.set_α!
— Methodset_α!(value::ExponentialLoad, val) -> Any
Set ExponentialLoad
α
.
PowerSystems.set_β!
— Methodset_β!(value::ExponentialLoad, val) -> Any
Set ExponentialLoad
β
.