TapTransformer
PowerSystems.TapTransformer
— Typemutable struct TapTransformer <: ACBranch
name::String
available::Bool
active_power_flow::Float64
reactive_power_flow::Float64
arc::Arc
r::Float64
x::Float64
primary_shunt::Float64
tap::Float64
rating::Union{Nothing, Float64}
services::Vector{Service}
ext::Dict{String, Any}
internal::InfrastructureSystemsInternal
end
A 2-winding transformer, with a tap changer for variable turns ratio.
The model uses an equivalent circuit assuming the impedance is on the High Voltage Side of the transformer. The model allocates the iron losses and magnetizing susceptance to the primary side
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 through the transformer (MW)reactive_power_flow::Float64
: Initial condition of reactive power flow through the transformer (MVAR)arc::Arc
: AnArc
defining this transformerfrom
a busto
another busr::Float64
: Resistance in p.u. (SYSTEM_BASE
), validation range:(-2, 2)
x::Float64
: Reactance in p.u. (SYSTEM_BASE
), validation range:(-2, 4)
primary_shunt::Float64
: Shunt reactance in p.u. (SYSTEM_BASE
), validation range:(0, 2)
tap::Float64
: Normalized tap changer position for voltage control, varying between 0 and 2, with 1 centered at the nominal voltage, validation range:(0, 2)
rating::Union{Nothing, Float64}
: Thermal rating (MVA). Flow through the transformer must be between -rating
. When defining a transformer before it is attached to aSystem
,rating
must be in pu (SYSTEM_BASE
) using the base power of theSystem
it will be attached to, validation range:(0, nothing)
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::TapTransformer) -> String
Get TapTransformer
name
.
PowerSystems.get_active_power_flow
— Methodget_active_power_flow(value::TapTransformer) -> Any
Get TapTransformer
active_power_flow
.
PowerSystems.get_arc
— Methodget_arc(value::TapTransformer) -> Arc
Get TapTransformer
arc
.
PowerSystems.get_available
— Methodget_available(value::TapTransformer) -> Bool
Get TapTransformer
available
.
PowerSystems.get_ext
— Methodget_ext(value::TapTransformer) -> Dict{String, Any}
Get TapTransformer
ext
.
PowerSystems.get_primary_shunt
— Methodget_primary_shunt(value::TapTransformer) -> Float64
Get TapTransformer
primary_shunt
.
PowerSystems.get_r
— Methodget_r(value::TapTransformer) -> Float64
Get TapTransformer
r
.
PowerSystems.get_rating
— Methodget_rating(value::TapTransformer) -> Any
Get TapTransformer
rating
.
PowerSystems.get_reactive_power_flow
— Methodget_reactive_power_flow(value::TapTransformer) -> Any
Get TapTransformer
reactive_power_flow
.
PowerSystems.get_services
— Methodget_services(value::TapTransformer) -> Vector{Service}
Get TapTransformer
services
.
PowerSystems.get_tap
— Methodget_tap(value::TapTransformer) -> Float64
Get TapTransformer
tap
.
PowerSystems.get_x
— Methodget_x(value::TapTransformer) -> Float64
Get TapTransformer
x
.
PowerSystems.set_active_power_flow!
— Methodset_active_power_flow!(value::TapTransformer, val) -> Any
Set TapTransformer
active_power_flow
.
PowerSystems.set_arc!
— Methodset_arc!(value::TapTransformer, val) -> Any
Set TapTransformer
arc
.
PowerSystems.set_available!
— Methodset_available!(value::TapTransformer, val) -> Any
Set TapTransformer
available
.
PowerSystems.set_ext!
— Methodset_ext!(value::TapTransformer, val) -> Any
Set TapTransformer
ext
.
PowerSystems.set_primary_shunt!
— Methodset_primary_shunt!(value::TapTransformer, val) -> Any
Set TapTransformer
primary_shunt
.
PowerSystems.set_r!
— Methodset_r!(value::TapTransformer, val) -> Any
Set TapTransformer
r
.
PowerSystems.set_rating!
— Methodset_rating!(value::TapTransformer, val) -> Any
Set TapTransformer
rating
.
PowerSystems.set_reactive_power_flow!
— Methodset_reactive_power_flow!(value::TapTransformer, val) -> Any
Set TapTransformer
reactive_power_flow
.
PowerSystems.set_services!
— Methodset_services!(value::TapTransformer, val) -> Any
Set TapTransformer
services
.
PowerSystems.set_tap!
— Methodset_tap!(value::TapTransformer, val) -> Any
Set TapTransformer
tap
.
PowerSystems.set_x!
— Methodset_x!(value::TapTransformer, val) -> Any
Set TapTransformer
x
.