Transformer2W

mutable struct Transformer2W <: TwoWindingTransformer
    name::String
    available::Bool
    active_power_flow::Float64
    reactive_power_flow::Float64
    arc::Arc
    r::Float64
    x::Float64
    primary_shunt::Complex{Float64}
    rating::Union{Nothing, Float64}
    base_power::Float64
    base_voltage_primary::Union{Nothing, Float64}
    base_voltage_secondary::Union{Nothing, Float64}
    rating_b::Union{Nothing, Float64}
    rating_c::Union{Nothing, Float64}
    winding_group_number::WindingGroupNumber
    services::Vector{Service}
    ext::Dict{String, Any}
    internal::InfrastructureSystemsInternal
end

A basic 2-winding transformer.

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 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
• active_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: An Arc defining this transformer from a bus to another bus
• r::Float64: Resistance in pu (SYSTEM_BASE), validation range: (-2, 4)
• x::Float64: Reactance in pu (SYSTEM_BASE), validation range: (-2, 4)
• primary_shunt::Complex{Float64}: Primary shunt admittance in pu (SYSTEM_BASE)
• rating::Union{Nothing, Float64}: Thermal rating (MVA). Flow through the transformer must be between -rating and rating. When defining a transformer before it is attached to a System, rating must be in pu (SYSTEM_BASE) using the base power of the System it will be attached to, validation range: (0, nothing)
• base_power::Float64: Base power (MVA) for per unitization, validation range: (0, nothing)
• base_voltage_primary::Union{Nothing, Float64}: (default: get_base_voltage(get_from(arc))) Primary base voltage in kV, validation range: (0, nothing)
• base_voltage_secondary::Union{Nothing, Float64}: (default: get_base_voltage(get_to(arc))) Secondary base voltage in kV, validation range: (0, nothing)
• rating_b::Union{Nothing, Float64}: (default: nothing) Second current rating; entered in MVA.
• rating_c::Union{Nothing, Float64}: (default: nothing) Third current rating; entered in MVA.
• winding_group_number::WindingGroupNumber: (default: WindingGroupNumber.UNDEFINED) Vector group number ('clock number') indicating phase shift (radians) between the from and to buses
• services::Vector{Service}: (default: Device[]) Services that this device contributes to
• ext::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

get_available(value::Transformer2W) -> Bool

Get Transformer2W available.

get_name(value::Transformer2W) -> String

Get Transformer2W name.

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

Set Transformer2W available.

get_active_power_flow(value::Transformer2W) -> Float64

Get Transformer2W active_power_flow.

get_arc(value::Transformer2W) -> Arc

Get Transformer2W arc.

get_base_power(value::Transformer2W) -> Float64

Get Transformer2W base_power.

get_base_voltage_primary(
    value::Transformer2W
) -> Union{Nothing, Float64}

Get Transformer2W base_voltage_primary.

get_base_voltage_secondary(
    value::Transformer2W
) -> Union{Nothing, Float64}

Get Transformer2W base_voltage_secondary.

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

Get Transformer2W ext.

get_primary_shunt(value::Transformer2W) -> ComplexF64

Get Transformer2W primary_shunt.

get_r(value::Transformer2W) -> Float64

Get Transformer2W r.

get_rating(value::Transformer2W) -> Union{Nothing, Float64}

Get Transformer2W rating.

get_rating_b(
    value::Transformer2W
) -> Union{Nothing, Float64}

Get Transformer2W rating_b.

get_rating_c(
    value::Transformer2W
) -> Union{Nothing, Float64}

Get Transformer2W rating_c.

get_reactive_power_flow(value::Transformer2W) -> Float64

Get Transformer2W reactive_power_flow.

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

Get Transformer2W services.

get_winding_group_number(
    value::Transformer2W
) -> WindingGroupNumber

Get Transformer2W winding_group_number.

get_x(value::Transformer2W) -> Float64

Get Transformer2W x.

set_active_power_flow!(value::Transformer2W, val) -> Any

Set Transformer2W active_power_flow.

set_arc!(value::Transformer2W, val) -> Any

Set Transformer2W arc.

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

Set Transformer2W base_power.

set_base_voltage_primary!(value::Transformer2W, val) -> Any

Set Transformer2W base_voltage_primary.

set_base_voltage_secondary!(
    value::Transformer2W,
    val
) -> Any

Set Transformer2W base_voltage_secondary.

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

Set Transformer2W ext.

set_primary_shunt!(value::Transformer2W, val) -> Any

Set Transformer2W primary_shunt.

set_r!(value::Transformer2W, val) -> Any

Set Transformer2W r.

set_rating!(value::Transformer2W, val) -> Any

Set Transformer2W rating.

set_rating_b!(value::Transformer2W, val) -> Any

Set Transformer2W rating_b.

set_rating_c!(value::Transformer2W, val) -> Any

Set Transformer2W rating_c.

set_reactive_power_flow!(value::Transformer2W, val) -> Any

Set Transformer2W reactive_power_flow.

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

Set Transformer2W services.

set_winding_group_number!(value::Transformer2W, val) -> Any

Set Transformer2W winding_group_number.

set_x!(value::Transformer2W, val) -> Any

Set Transformer2W x.