MonitoredLine
PowerSystems.MonitoredLine
— Typemutable struct MonitoredLine <: ACBranch
name::String
available::Bool
active_power_flow::Float64
reactive_power_flow::Float64
arc::Arc
r::Float64
x::Float64
b::FromTo
flow_limits::FromTo_ToFrom
rating::Float64
angle_limits::MinMax
g::FromTo
services::Vector{Service}
ext::Dict{String, Any}
internal::InfrastructureSystemsInternal
end
An AC transmission line with additional power flow constraints specified by the system operator, more restrictive than the line's thermal limits.
For example, monitored lines can be used to restrict line flow following a contingency elsewhere in the network. See the flow_limits
parameter. If monitoring is not needed, see Line
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 simulationsactive_power_flow::Float64
: Initial condition of active power flow on the line (MW)reactive_power_flow::Float64
: Initial condition of reactive power flow on the line (MVAR)arc::Arc
: AnArc
defining this linefrom
a busto
another busr::Float64
: Resistance in pu (SYSTEM_BASE
), validation range:(0, 4)
x::Float64
: Reactance in pu (SYSTEM_BASE
), validation range:(0, 4)
b::FromTo
: Shunt susceptance in pu (SYSTEM_BASE
), specified both on thefrom
andto
ends of the line. These are commonly modeled with the same value, validation range:(0, 2)
flow_limits::FromTo_ToFrom
: Minimum and maximum permissable flow on the line (MVA), if different from the thermal rating defined inrating
rating::Float64
: Thermal rating (MVA). Flow through the transformer must be between -rating
andrating
. When defining a line before it is attached to aSystem
,rating
must be in pu (SYSTEM_BASE
) using the base power of theSystem
it will be attached toangle_limits::MinMax
: Minimum and maximum angle limits (radians), validation range:(-1.571, 1.571)
g::FromTo
: (default:(from=0.0, to=0.0)
) Shunt conductance in pu (SYSTEM_BASE
), specified both on thefrom
andto
ends of the line. These are commonly modeled with the same value, validation range:(0, 100)
services::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, such as latitude and longitude.internal::InfrastructureSystemsInternal
: (Do not modify.) PowerSystems.jl internal reference
InfrastructureSystems.get_name
— Methodget_name(value::MonitoredLine) -> String
Get MonitoredLine
name
.
PowerSystems.get_active_power_flow
— Methodget_active_power_flow(value::MonitoredLine) -> Any
Get MonitoredLine
active_power_flow
.
PowerSystems.get_angle_limits
— Methodget_angle_limits(
value::MonitoredLine
) -> @NamedTuple{min::Float64, max::Float64}
Get MonitoredLine
angle_limits
.
PowerSystems.get_arc
— Methodget_arc(value::MonitoredLine) -> Arc
Get MonitoredLine
arc
.
PowerSystems.get_available
— Methodget_available(value::MonitoredLine) -> Bool
Get MonitoredLine
available
.
PowerSystems.get_b
— Methodget_b(
value::MonitoredLine
) -> @NamedTuple{from::Float64, to::Float64}
Get MonitoredLine
b
.
PowerSystems.get_ext
— Methodget_ext(value::MonitoredLine) -> Dict{String, Any}
Get MonitoredLine
ext
.
PowerSystems.get_flow_limits
— Methodget_flow_limits(
value::MonitoredLine
) -> NamedTuple{(:from_to, :to_from), <:Tuple{Any, Any}}
Get MonitoredLine
flow_limits
.
PowerSystems.get_g
— Methodget_g(
value::MonitoredLine
) -> @NamedTuple{from::Float64, to::Float64}
Get MonitoredLine
g
.
PowerSystems.get_r
— Methodget_r(value::MonitoredLine) -> Float64
Get MonitoredLine
r
.
PowerSystems.get_rating
— Methodget_rating(value::MonitoredLine) -> Any
Get MonitoredLine
rating
.
PowerSystems.get_reactive_power_flow
— Methodget_reactive_power_flow(value::MonitoredLine) -> Any
Get MonitoredLine
reactive_power_flow
.
PowerSystems.get_services
— Methodget_services(value::MonitoredLine) -> Vector{Service}
Get MonitoredLine
services
.
PowerSystems.get_x
— Methodget_x(value::MonitoredLine) -> Float64
Get MonitoredLine
x
.
PowerSystems.set_active_power_flow!
— Methodset_active_power_flow!(value::MonitoredLine, val) -> Any
Set MonitoredLine
active_power_flow
.
PowerSystems.set_angle_limits!
— Methodset_angle_limits!(value::MonitoredLine, val) -> Any
Set MonitoredLine
angle_limits
.
PowerSystems.set_arc!
— Methodset_arc!(value::MonitoredLine, val) -> Any
Set MonitoredLine
arc
.
PowerSystems.set_available!
— Methodset_available!(value::MonitoredLine, val) -> Any
Set MonitoredLine
available
.
PowerSystems.set_b!
— Methodset_b!(value::MonitoredLine, val) -> Any
Set MonitoredLine
b
.
PowerSystems.set_ext!
— Methodset_ext!(value::MonitoredLine, val) -> Any
Set MonitoredLine
ext
.
PowerSystems.set_flow_limits!
— Methodset_flow_limits!(value::MonitoredLine, val) -> Any
Set MonitoredLine
flow_limits
.
PowerSystems.set_g!
— Methodset_g!(value::MonitoredLine, val) -> Any
Set MonitoredLine
g
.
PowerSystems.set_r!
— Methodset_r!(value::MonitoredLine, val) -> Any
Set MonitoredLine
r
.
PowerSystems.set_rating!
— Methodset_rating!(value::MonitoredLine, val) -> Any
Set MonitoredLine
rating
.
PowerSystems.set_reactive_power_flow!
— Methodset_reactive_power_flow!(value::MonitoredLine, val) -> Any
Set MonitoredLine
reactive_power_flow
.
PowerSystems.set_services!
— Methodset_services!(value::MonitoredLine, val) -> Any
Set MonitoredLine
services
.
PowerSystems.set_x!
— Methodset_x!(value::MonitoredLine, val) -> Any
Set MonitoredLine
x
.