AVR

AVRFixed

PowerSystems.AVRFixedType
mutable struct AVRFixed <: AVR
    Vf::Float64
    V_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Parameters of a AVR that returns a fixed voltage to the rotor winding

Arguments

  • Vf::Float64: Fixed voltage field applied to the rotor winding in pu (DEVICE_BASE), validation range: (0, nothing)
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • 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.
  • states::Vector{Symbol}: (Do not modify.) Fixed AVR has no states
  • n_states::Int: (Do not modify.) Fixed AVR has no states
  • states_types::Vector{StateTypes}: (Do not modify.) Fixed AVR has no states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

AVRSimple

PowerSystems.AVRSimpleType
mutable struct AVRSimple <: AVR
    Kv::Float64
    V_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Parameters of a simple proportional AVR in the derivative of EMF i.e. an integrator controller on EMF

Arguments

  • Kv::Float64: Proportional Gain, validation range: (0, nothing)
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vf: field voltage
  • n_states::Int: (Do not modify.) Fixed AVR has 1 state
  • states_types::Vector{StateTypes}: (Do not modify.) Simple AVR has 1 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

AVRTypeI

PowerSystems.AVRTypeIType
mutable struct AVRTypeI <: AVR
    Ka::Float64
    Ke::Float64
    Kf::Float64
    Ta::Float64
    Te::Float64
    Tf::Float64
    Tr::Float64
    Va_lim::MinMax
    Ae::Float64
    Be::Float64
    V_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Parameters of an Automatic Voltage Regulator Type I - Resembles IEEE Type DC1

Arguments

  • Ka::Float64: Amplifier Gain, validation range: (0, nothing)
  • Ke::Float64: Field circuit integral deviation, validation range: (0, nothing)
  • Kf::Float64: Stabilizer Gain in s * pu/pu, validation range: (0, nothing)
  • Ta::Float64: Amplifier Time Constant in s, validation range: (0, nothing)
  • Te::Float64: Field Circuit Time Constant in s, validation range: (0, nothing)
  • Tf::Float64: Stabilizer Time Constant in s, validation range: (0, nothing)
  • Tr::Float64: Voltage Measurement Time Constant in s, validation range: (0, nothing)
  • Va_lim::MinMax: Limits for pi controler (Va_min, Va_max)
  • Ae::Float64: 1st ceiling coefficient, validation range: (0, nothing)
  • Be::Float64: 2nd ceiling coefficient, validation range: (0, nothing)
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vf: Voltage field,
Vr1: Amplifier State,
Vr2: Stabilizing Feedback State,
Vm: Measured voltage
  • n_states::Int: (Do not modify.) The AVR Type I has 4 states
  • states_types::Vector{StateTypes}: (Do not modify.) AVR Type I has 4 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

AVRTypeII

PowerSystems.AVRTypeIIType
mutable struct AVRTypeII <: AVR
    K0::Float64
    T1::Float64
    T2::Float64
    T3::Float64
    T4::Float64
    Te::Float64
    Tr::Float64
    Va_lim::MinMax
    Ae::Float64
    Be::Float64
    V_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Parameters of an Automatic Voltage Regulator Type II - Typical static exciter model

Arguments

  • K0::Float64: Regulator Gain, validation range: (0, nothing)
  • T1::Float64: First Pole in s, validation range: (0, nothing)
  • T2::Float64: First zero in s, validation range: (0, nothing)
  • T3::Float64: First Pole in s, validation range: (0, nothing)
  • T4::Float64: First zero in s, validation range: (0, nothing)
  • Te::Float64: Field Circuit Time Constant in s, validation range: (0, nothing)
  • Tr::Float64: Voltage Measurement Time Constant in s, validation range: (0, nothing)
  • Va_lim::MinMax: Limits for pi controler (Va_min, Va_max)
  • Ae::Float64: 1st ceiling coefficient, validation range: (0, nothing)
  • Be::Float64: 2nd ceiling coefficient, validation range: (0, nothing)
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vf: Voltage field,
Vr1: First Lead-Lag state,
Vr2: Second lead-lag state,
Vm: Measured voltage
  • n_states::Int: (Do not modify.) AVR Type II has 4 states
  • states_types::Vector{StateTypes}: (Do not modify.) AVR Type II has 4 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

ESAC1A

PowerSystems.ESAC1AType
mutable struct ESAC1A <: AVR
    Tr::Float64
    Tb::Float64
    Tc::Float64
    Ka::Float64
    Ta::Float64
    Va_lim::MinMax
    Te::Float64
    Kf::Float64
    Tf::Float64
    Kc::Float64
    Kd::Float64
    Ke::Float64
    E_sat::Tuple{Float64, Float64}
    Se::Tuple{Float64, Float64}
    Vr_lim::MinMax
    V_ref::Float64
    saturation_coeffs::Tuple{Float64, Float64}
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

This excitation systems consists of an alternator main exciter feeding its output via non-controlled rectifiers. The exciter does not employ self-excitation, and the voltage regulator power is taken from a source that is not affected by external transients. Parameters of IEEE Std 421.5 Type AC1A Excitacion System. This model corresponds to ESAC1A in PSSE and PSLF

Arguments

  • Tr::Float64: Regulator input filter time constant in s, validation range: (0, 0.5)
  • Tb::Float64: Regulator denominator (lag) time constant in s, validation range: (0, 20)
  • Tc::Float64: Regulator numerator (lead) time constant in s, validation range: (0, 20)
  • Ka::Float64: Regulator output gain, validation range: (0, 1000)
  • Ta::Float64: Regulator output time constant in s, validation range: (0, 10)
  • Va_lim::MinMax: Limits for regulator output (Va_min, Va_max)
  • Te::Float64: Exciter field time constant in s, validation range: (eps(), 2)
  • Kf::Float64: Rate feedback excitation system stabilizer gain, validation range: (0, 0.3)
  • Tf::Float64: Rate feedback time constant, validation range: (eps(), 1.5)
  • Kc::Float64: Rectifier loading factor proportional to commutating reactance, validation range: (0, 1)
  • Kd::Float64: Demagnetizing factor, function of exciter alternator reactances, validation range: (0, 1)
  • Ke::Float64: Exciter field proportional constant, validation range: (0, 1)
  • E_sat::Tuple{Float64, Float64}: Exciter output voltage for saturation factor: (E1, E2)
  • Se::Tuple{Float64, Float64}: Exciter saturation factor at exciter output voltage: (Se(E1), Se(E2))
  • Vr_lim::MinMax: Limits for exciter field voltage: (Vr_min, Vr_max)
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: (default: PowerSystems.get_avr_saturation(E_sat, Se)) (Do not modify.) Coefficients (A,B) of the function: Se(x) = B(x - A)^2/x
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vm: Sensed terminal voltage,
Vr1: Lead-lag state,
Vr2: Regulator output state,
Ve: Integrator output state,
Vr3: Feedback output state
  • n_states::Int: (Do not modify.) ESAC1A has 5 states
  • states_types::Vector{StateTypes}: (Do not modify.) ESAC1A has 5 states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

ESAC6A

PowerSystems.ESAC6AType
mutable struct ESAC6A <: AVR
    Tr::Float64
    Ka::Float64
    Ta::Float64
    Tk::Float64
    Tb::Float64
    Tc::Float64
    Va_lim::MinMax
    Vr_lim::MinMax
    Te::Float64
    VFE_lim::Float64
    Kh::Float64
    VH_max::Float64
    Th::Float64
    Tj::Float64
    Kc::Float64
    Kd::Float64
    Ke::Float64
    E_sat::Tuple{Float64, Float64}
    Se::Tuple{Float64, Float64}
    V_ref::Float64
    saturation_coeffs::Tuple{Float64, Float64}
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Modified AC6A. Used to represent field-controlled alternator-rectifier excitation systems with system-supplied electronic voltage regulators. Parameters of IEEE Std 421.5 Type AC6A Excitacion System. ESAC6A in PSSE and PSLF

Arguments

  • Tr::Float64: Regulator input filter time constant in s, validation range: (0, 0.5)
  • Ka::Float64: Regulator output gain, validation range: (0, 1000)
  • Ta::Float64: Regulator output lag time constant in s, validation range: (0, 10)
  • Tk::Float64: Voltage Regulator lead time constant, validation range: (0, 10)
  • Tb::Float64: Regulator denominator (lag) time constant in s, validation range: (0, 20)
  • Tc::Float64: Regulator numerator (lead) time constant in s, validation range: (0, 20)
  • Va_lim::MinMax: Limits for regulator output (Va_min, Va_max)
  • Vr_lim::MinMax: Limits for exciter field voltage (Vr_min, Vr_max)
  • Te::Float64: Exciter field time constant, validation range: (eps(), 2)
  • VFE_lim::Float64: Exciter field current limiter reference, validation range: (-5, 20)
  • Kh::Float64: Exciter field current regulator feedback gain, validation range: (0, 100)
  • VH_max::Float64: Exciter field current limiter maximum output, validation range: (0, 100)
  • Th::Float64: Exciter field current limiter denominator (lag) time constant, validation range: (0, 1)
  • Tj::Float64: Exciter field current limiter numerator (lead) time constant, validation range: (0, 1)
  • Kc::Float64: Rectifier loading factor proportional to commutating reactance, validation range: (0, 1)
  • Kd::Float64: Demagnetizing factor, function of exciter alternator reactances, validation range: (0, 2)
  • Ke::Float64: Exciter field proportional constant, validation range: (0, 2)
  • E_sat::Tuple{Float64, Float64}: Exciter output voltage for saturation factor: (E1, E2)
  • Se::Tuple{Float64, Float64}: Exciter saturation factor at exciter output voltage: (Se(E1), Se(E2))
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: (default: PowerSystems.get_avr_saturation(E_sat, Se)) (Do not modify.) Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vm: Sensed terminal voltage,
Vr1: Lead-lag state,
Vr2: Regulator output state,
Ve: Integrator output state,
Vr3: Feedback output state
  • n_states::Int: (Do not modify.) ESAC6A has 5 states
  • states_types::Vector{StateTypes}: (Do not modify.) ESAC6A has 5 states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

ESAC8B

PowerSystems.ESAC8BType
mutable struct ESAC8B <: AVR
    Tr::Float64
    Kp::Float64
    Ki::Float64
    Kd::Float64
    Td::Float64
    Ka::Float64
    Ta::Float64
    Vr_lim::MinMax
    Te::Float64
    Ke::Float64
    E_sat::Tuple{Float64, Float64}
    Se::Tuple{Float64, Float64}
    V_ref::Float64
    saturation_coeffs::Tuple{Float64, Float64}
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Excitation System AC8B. Used to represent the Basler Digital Excitation Control System (DECS) with PID controller in PSSE.

Arguments

  • Tr::Float64: Regulator input filter time constant in s, validation range: (0, nothing)
  • Kp::Float64: Regulator proportional PID gain, validation range: (0, nothing)
  • Ki::Float64: Regulator integral PID gain, validation range: (0, nothing)
  • Kd::Float64: Regulator derivative PID gain, validation range: (0, nothing)
  • Td::Float64: Regulator derivative PID time constant., validation range: (0, 10)
  • Ka::Float64: Regulator output gain, validation range: (0, 1000)
  • Ta::Float64: Regulator output lag time constant in s, validation range: (0, 10)
  • Vr_lim::MinMax: Limits for exciter field voltage (Vr_min, Vr_max)
  • Te::Float64: Exciter field time constant, validation range: (eps(), 2)
  • Ke::Float64: Exciter field proportional constant, validation range: (0, 2)
  • E_sat::Tuple{Float64, Float64}: Exciter output voltage for saturation factor: (E1, E2)
  • Se::Tuple{Float64, Float64}: Exciter saturation factor at exciter output voltage: (Se(E1), Se(E2))
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: (default: PowerSystems.get_avr_saturation(E_sat, Se)) (Do not modify.) Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vm: Sensed terminal voltage,
x_i: Internal PI-block state,
x_d: Internal Derivative-block state,
Vr: Voltage regulator state,
Efd: Exciter output state
  • n_states::Int: (Do not modify.) ESAC8B has 5 states
  • states_types::Vector{StateTypes}: (Do not modify.) ESAC8B has 5 states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

ESDC1A

PowerSystems.ESDC1AType
mutable struct ESDC1A <: AVR
    Tr::Float64
    Ka::Float64
    Ta::Float64
    Tb::Float64
    Tc::Float64
    Vr_lim::MinMax
    Ke::Float64
    Te::Float64
    Kf::Float64
    Tf::Float64
    switch::Int
    E_sat::Tuple{Float64, Float64}
    Se::Tuple{Float64, Float64}
    V_ref::Float64
    saturation_coeffs::Tuple{Float64, Float64}
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Self-excited shunt fields with the voltage regulator operating in a mode commonly termed buck-boost. Parameters of IEEE Std 421.5 Type DC1A Excitacion System. This model corresponds to ESDC1A in PSSE and PSLF

Arguments

  • Tr::Float64: Voltage Measurement Time Constant in s, validation range: (0, 0.5)
  • Ka::Float64: Amplifier Gain, validation range: (10, 500)
  • Ta::Float64: Amplifier Time Constant in s, validation range: (0, 1)
  • Tb::Float64: Regulator input Time Constant in s, validation range: (0, nothing)
  • Tc::Float64: Regulator input Time Constant in s, validation range: (0, nothing)
  • Vr_lim::MinMax: Voltage regulator limits (regulator output) (Vimin, Vimax)
  • Ke::Float64: Exciter constant related to self-excited field, validation range: (0, nothing)
  • Te::Float64: Exciter time constant, integration rate associated with exciter control, validation range: (eps(), 1)
  • Kf::Float64: Excitation control system stabilizer gain, validation range: (eps(), 0.3)
  • Tf::Float64: Excitation control system stabilizer time constant, validation range: (eps(), nothing)
  • switch::Int: Switch, validation range: (0, 1)
  • E_sat::Tuple{Float64, Float64}: Exciter output voltage for saturation factor: (E1, E2)
  • Se::Tuple{Float64, Float64}: Exciter saturation factor at exciter output voltage: (Se(E1), Se(E2))
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: (default: PowerSystems.get_avr_saturation(E_sat, Se)) (Do not modify.) Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vt: Terminal Voltage,
Vr1: input lead lag,
Vr2: Regulator Output,
Vf: Exciter Output, 
Vr3: Rate feedback integrator
  • n_states::Int: (Do not modify.) The ESDC1A has 5 states
  • states_types::Vector{StateTypes}: (Do not modify.) ESDC1A has 5 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

ESDC2A

PowerSystems.ESDC2AType
mutable struct ESDC2A <: AVR
    Tr::Float64
    Ka::Float64
    Ta::Float64
    Tb::Float64
    Tc::Float64
    Vr_lim::MinMax
    Ke::Float64
    Te::Float64
    Kf::Float64
    Tf::Float64
    switch::Int
    E_sat::Tuple{Float64, Float64}
    Se::Tuple{Float64, Float64}
    V_ref::Float64
    saturation_coeffs::Tuple{Float64, Float64}
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Is used to represent field-controlled dc commutator exciters with continuously acting voltage regulators having power supplies derived from the generator or auxiliaries bus. Parameters of IEEE Std 421.5 Type DC2A Excitacion System. This model corresponds to ESDC2A in PSSE and PSLF

Arguments

  • Tr::Float64: Voltage Measurement Time Constant in s, validation range: (0, 0.5)
  • Ka::Float64: Amplifier Gain, validation range: (10, 500)
  • Ta::Float64: Amplifier Time Constant in s, validation range: (0, 1)
  • Tb::Float64: Regulator input Time Constant in s, validation range: (0, nothing)
  • Tc::Float64: Regulator input Time Constant in s, validation range: (0, nothing)
  • Vr_lim::MinMax: Voltage regulator limits (regulator output) (Vimin, Vimax)
  • Ke::Float64: Exciter constant related to self-excited field, validation range: (-1, 1)
  • Te::Float64: Exciter time constant, integration rate associated with exciter control, validation range: (eps(), 2)
  • Kf::Float64: Excitation control system stabilizer gain, validation range: (0, 0.3)
  • Tf::Float64: Excitation control system stabilizer time constant. Appropiate Data: 5.0 <= Tf/Kf <= 15.0, validation range: (eps(), 1.5)
  • switch::Int: Switch, validation range: (0, 1)
  • E_sat::Tuple{Float64, Float64}: Exciter output voltage for saturation factor: (E1, E2)
  • Se::Tuple{Float64, Float64}: Exciter saturation factor at exciter output voltage: (Se(E1), Se(E2))
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: (default: PowerSystems.get_avr_saturation(E_sat, Se)) (Do not modify.) Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vt: Terminal Voltage,
Vr1: input lead lag,
Vr2: Regulator Output,
Vf: Exciter Output, 
Vr3: Rate feedback integrator
  • n_states::Int: (Do not modify.) The ESDC2A has 5 states
  • states_types::Vector{StateTypes}: (Do not modify.) ESDC2A has 5 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

ESST1A

PowerSystems.ESST1AType
mutable struct ESST1A <: AVR
    UEL_flags::Int
    PSS_flags::Int
    Tr::Float64
    Vi_lim::Tuple{Float64, Float64}
    Tc::Float64
    Tb::Float64
    Tc1::Float64
    Tb1::Float64
    Ka::Float64
    Ta::Float64
    Va_lim::MinMax
    Vr_lim::MinMax
    Kc::Float64
    Kf::Float64
    Tf::Float64
    K_lr::Float64
    I_lr::Float64
    V_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

This excitation system supplies power through a transformer from the generator terminals and its regulated by a controlled rectifier (via thyristors). Parameters of IEEE Std 421.5 Type ST1A Excitacion System. ESST1A in PSSE and PSLF

Arguments

  • UEL_flags::Int: Code input for Underexcitization limiter (UEL) entry. Not supported, validation range: (1, 3)
  • PSS_flags::Int: Code input for Power System Stabilizer (PSS) or (VOS) entry, validation range: (1, 2)
  • Tr::Float64: Regulator input filter time constant in s, validation range: (0, 0.1)
  • Vi_lim::Tuple{Float64, Float64}: Voltage error limits (regulator input) (Vimin, Vimax)
  • Tc::Float64: First regulator denominator (lead) time constant in s, validation range: (0, 10)
  • Tb::Float64: First regulator denominator (lag) time constant in s, validation range: (0, 20)
  • Tc1::Float64: Second regulator denominator (lead) time constant in s, validation range: (0, 10)
  • Tb1::Float64: Second regulator denominator (lead) time constant in s, validation range: (0, 20)
  • Ka::Float64: Voltage regulator gain, validation range: (50, 1000)
  • Ta::Float64: Voltage regulator time constant in s, validation range: (0, 0.5)
  • Va_lim::MinMax: Limits for regulator output (Va_min, Va_max)
  • Vr_lim::MinMax: Limits for exciter output (Vr_min, Vr_max)
  • Kc::Float64: Rectifier loading factor proportional to commutating reactance, validation range: (0, 0.3)
  • Kf::Float64: Rate feedback gain, validation range: (0, 0.3)
  • Tf::Float64: Rate feedback time constant in s, validation range: (eps(), 1.5)
  • K_lr::Float64: Exciter output current limiter gain, validation range: (0, 5)
  • I_lr::Float64: Exciter output current limit reference, validation range: (0, 5)
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vm: Sensed terminal voltage,
Vr1: First Lead-lag state,
Vr2: Second lead-lag state,
Va: Regulator output state,
Vr3: Feedback output state
  • n_states::Int: (Do not modify.) ST1A has 5 states
  • states_types::Vector{StateTypes}: (Do not modify.) ST1A has 5 states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

ESST4B

PowerSystems.ESST4BType
mutable struct ESST4B <: AVR
    Tr::Float64
    K_pr::Float64
    K_ir::Float64
    Vr_lim::MinMax
    Ta::Float64
    K_pm::Float64
    K_im::Float64
    Vm_lim::MinMax
    Kg::Float64
    Kp::Float64
    Ki::Float64
    VB_max::Float64
    Kc::Float64
    Xl::Float64
    θp::Float64
    V_ref::Float64
    θp_rad::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

In these excitation systems, voltage (and also current in compounded systems) is transformed to an appropriate level. Rectifiers, either controlled or non-controlled, provide the necessary direct current for the generator field. Parameters of IEEE Std 421.5 Type ST4B Excitacion System. ESST4B in PSSE and PSLF

Arguments

  • Tr::Float64: Regulator input filter time constant in s, validation range: (0, 0.5)
  • K_pr::Float64: Regulator propotional gain, validation range: (0, 75)
  • K_ir::Float64: Regulator integral gain, validation range: (0, 75)
  • Vr_lim::MinMax: Voltage regulator limits (Vimin, Vimax)
  • Ta::Float64: Voltage regulator time constant in s, validation range: (0, 1)
  • K_pm::Float64: Voltage regulator proportional gain output, validation range: (0, 1.2)
  • K_im::Float64: Voltage regulator integral gain output, validation range: (0, 18)
  • Vm_lim::MinMax: Limits for inner loop output (Vm_min, Vm_max)
  • Kg::Float64: Feedback gain constant of the inner loop field regulator, validation range: (0, 1.1)
  • Kp::Float64: Potential circuit (voltage) gain coefficient, validation range: (0, 10)
  • Ki::Float64: Compound circuit (current) gain coefficient, validation range: (0, 1.1)
  • VB_max::Float64: Maximum available exciter voltage, validation range: (1, 20)
  • Kc::Float64: Rectifier loading factor proportional to commutating reactance, validation range: (0, 1)
  • Xl::Float64: Reactance associated with potential source, validation range: (0, 0.5)
  • θp::Float64: Potential circuit phase angle (degrees), validation range: (-90, 90)
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • θp_rad::Float64: (default: θp*π*inv(180)) (Do not modify.) Potential circuit phase angle (radians)
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vm: Sensed terminal voltage,
Vt: Sensed Terminal Voltage,
Vr1: Regulator Integrator,
Vr2: Regulator Output,
Vm: Output integrator
  • n_states::Int: (Do not modify.) ST4B has 4 states
  • states_types::Vector{StateTypes}: (Do not modify.) ST4B has 4 states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

EXAC1

PowerSystems.EXAC1Type
mutable struct EXAC1 <: AVR
    Tr::Float64
    Tb::Float64
    Tc::Float64
    Ka::Float64
    Ta::Float64
    Vr_lim::MinMax
    Te::Float64
    Kf::Float64
    Tf::Float64
    Kc::Float64
    Kd::Float64
    Ke::Float64
    E_sat::Tuple{Float64, Float64}
    Se::Tuple{Float64, Float64}
    V_ref::Float64
    saturation_coeffs::Tuple{Float64, Float64}
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Modified ESAC1A. This excitation systems consists of an alternator main exciter feeding its output via non-controlled rectifiers. The exciter does not employ self-excitation, and the voltage regulator power is taken from a source that is not affected by external transients. Parameters of IEEE Std 421.5 Type AC1A. EXAC1 in PSSE and PSLF

Arguments

  • Tr::Float64: Regulator input filter time constant in s, validation range: (0, 0.5)
  • Tb::Float64: Regulator denominator (lag) time constant in s, validation range: (0, 20)
  • Tc::Float64: Regulator numerator (lead) time constant in s, validation range: (0, 20)
  • Ka::Float64: Regulator output gain, validation range: (0, 1000)
  • Ta::Float64: Regulator output time constant in s, validation range: (0, 10)
  • Vr_lim::MinMax: Limits for regulator output (Vr_min, Vr_max)
  • Te::Float64: Exciter field time constant in s, validation range: (eps(), 2)
  • Kf::Float64: Rate feedback excitation system stabilizer gain, validation range: (0, 0.3)
  • Tf::Float64: Rate feedback time constant, validation range: (eps(), 1.5)
  • Kc::Float64: Rectifier loading factor proportional to commutating reactance, validation range: (0, 1)
  • Kd::Float64: Demagnetizing factor, function of exciter alternator reactances, validation range: (0, 1)
  • Ke::Float64: Exciter field proportional constant, validation range: (0, 1)
  • E_sat::Tuple{Float64, Float64}: Exciter output voltage for saturation factor: (E1, E2)
  • Se::Tuple{Float64, Float64}: Exciter saturation factor at exciter output voltage: (Se(E1), Se(E2))
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: (default: PowerSystems.get_avr_saturation(E_sat, Se)) (Do not modify.) Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vm: Sensed terminal voltage,
Vr1: Lead-lag state,
Vr2: Regulator output state,
Ve: Integrator output state,
Vr3: Feedback output state
  • n_states::Int: (Do not modify.) EXAC1 has 5 states
  • states_types::Vector{StateTypes}: (Do not modify.) EXAC1 has 5 states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

EXAC1A

PowerSystems.EXAC1AType
mutable struct EXAC1A <: AVR
    Tr::Float64
    Tb::Float64
    Tc::Float64
    Ka::Float64
    Ta::Float64
    Va_lim::MinMax
    Te::Float64
    Kf::Float64
    Tf::Float64
    Kc::Float64
    Kd::Float64
    Ke::Float64
    E_sat::Tuple{Float64, Float64}
    Se::Tuple{Float64, Float64}
    Vr_lim::MinMax
    V_ref::Float64
    saturation_coeffs::Tuple{Float64, Float64}
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Modified ESAC1A. This excitation systems consists of an alternator main exciter feeding its output via non-controlled rectifiers. The exciter does not employ self-excitation, and the voltage regulator power is taken from a source that is not affected by external transients. Parameters of IEEE Std 421.5 Type AC1A Excitacion System. EXAC1A in PSSE and PSLF

Arguments

  • Tr::Float64: Regulator input filter time constant in s, validation range: (0, 0.5)
  • Tb::Float64: Regulator denominator (lag) time constant in s, validation range: (0, 20)
  • Tc::Float64: Regulator numerator (lead) time constant in s, validation range: (0, 20)
  • Ka::Float64: Regulator output gain, validation range: (0, 1000)
  • Ta::Float64: Regulator output time constant in s, validation range: (0, 10)
  • Va_lim::MinMax: Limits for regulator output (Va_min, Va_max)
  • Te::Float64: Exciter field time constant in s, validation range: (eps(), 2)
  • Kf::Float64: Rate feedback excitation system stabilizer gain, validation range: (0, 0.3)
  • Tf::Float64: Rate feedback time constant, validation range: (eps(), 1.5)
  • Kc::Float64: Rectifier loading factor proportional to commutating reactance, validation range: (0, 1)
  • Kd::Float64: Demagnetizing factor, function of exciter alternator reactances, validation range: (0, 1)
  • Ke::Float64: Exciter field proportional constant, validation range: (0, 1)
  • E_sat::Tuple{Float64, Float64}: Exciter output voltage for saturation factor: (E1, E2)
  • Se::Tuple{Float64, Float64}: Exciter saturation factor at exciter output voltage: (Se(E1), Se(E2))
  • Vr_lim::MinMax: Limits for exciter field voltage: (Vr_min, Vr_max)
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: (default: PowerSystems.get_avr_saturation(E_sat, Se)) (Do not modify.) Coefficients (A,B) of the function: Se(x) = B(x - A)^2/x
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vm: Sensed terminal voltage,
Vr1: Lead-lag state,
Vr2: Regulator output state,
Ve: Integrator output state,
Vr3: Feedback output state
  • n_states::Int: (Do not modify.) EXAC1A has 5 states
  • states_types::Vector{StateTypes}: (Do not modify.) EXAC1A has 5 states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

EXAC2

PowerSystems.EXAC2Type
mutable struct EXAC2 <: AVR
    Tr::Float64
    Tb::Float64
    Tc::Float64
    Ka::Float64
    Ta::Float64
    Va_lim::MinMax
    Kb::Float64
    Vr_lim::MinMax
    Te::Float64
    Kl::Float64
    Kh::Float64
    Kf::Float64
    Tf::Float64
    Kc::Float64
    Kd::Float64
    Ke::Float64
    V_lr::Float64
    E_sat::Tuple{Float64, Float64}
    Se::Tuple{Float64, Float64}
    V_ref::Float64
    saturation_coeffs::Tuple{Float64, Float64}
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Modified AC2. This excitation systems consists of an alternator main exciter feeding its output via non-controlled rectifiers. The exciter does not employ self-excitation, and the voltage regulator power is taken from a source that is not affected by external transients. Parameters of IEEE Std 421.5 Type AC2A Excitacion System. The alternator main exciter is used, feeding its output via non-controlled rectifiers. The Type AC2C model is similar to that of Type AC1C except for the inclusion of exciter time constant compensation and exciter field current limiting elements. EXAC2 in PSSE and PSLF

Arguments

  • Tr::Float64: Regulator input filter time constant in s, validation range: (0, 0.5)
  • Tb::Float64: Regulator denominator (lag) time constant in s, validation range: (0, 20)
  • Tc::Float64: Regulator numerator (lead) time constant in s, validation range: (0, 20)
  • Ka::Float64: Regulator output gain, validation range: (0, 1000)
  • Ta::Float64: Regulator output time constant in s, validation range: (0, 10)
  • Va_lim::MinMax: Limits for regulator output (Va_min, Va_max)
  • Kb::Float64: Second Stage regulator gain, validation range: (eps(), 500)
  • Vr_lim::MinMax: Limits for exciter field voltage (Vr_min, Vr_max)
  • Te::Float64: Exciter field time constant, validation range: (eps(), 2)
  • Kl::Float64: Exciter field current limiter gain, validation range: (0, 1.1)
  • Kh::Float64: Exciter field current regulator feedback gain, validation range: (0, 1.1)
  • Kf::Float64: Rate feedback excitation system stabilizer gain, validation range: (0, 0.3)
  • Tf::Float64: Rate feedback time constant, validation range: (eps(), nothing)
  • Kc::Float64: Rectifier loading factor proportional to commutating reactance, validation range: (0, 1)
  • Kd::Float64: Demagnetizing factor, function of exciter alternator reactances, validation range: (0, 1)
  • Ke::Float64: Exciter field proportional constant, validation range: (0, 1)
  • V_lr::Float64: Maximum exciter field current, validation range: (0, nothing)
  • E_sat::Tuple{Float64, Float64}: Exciter output voltage for saturation factor: (E1, E2)
  • Se::Tuple{Float64, Float64}: Exciter saturation factor at exciter output voltage: (Se(E1), Se(E2))
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: (default: PowerSystems.get_avr_saturation(E_sat, Se)) (Do not modify.) Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vm: Sensed terminal voltage,
Vr1: Lead-lag state,
Vr2: Regulator output state,
Ve: Integrator output state,
Vr3: Feedback output state
  • n_states::Int: (Do not modify.) EXAC2 has 5 states
  • states_types::Vector{StateTypes}: (Do not modify.) EXAC2 has 5 states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

EXPIC1

PowerSystems.EXPIC1Type
mutable struct EXPIC1 <: AVR
    Tr::Float64
    Ka::Float64
    Ta::Float64
    Va_lim::MinMax
    Ta_2::Float64
    Ta_3::Float64
    Ta_4::Float64
    Vr_lim::MinMax
    Kf::Float64
    Tf_1::Float64
    Tf_2::Float64
    Efd_lim::MinMax
    Ke::Float64
    Te::Float64
    E_sat::Tuple{Float64, Float64}
    Se::Tuple{Float64, Float64}
    Kp::Float64
    Ki::Float64
    Kc::Float64
    V_ref::Float64
    saturation_coeffs::Tuple{Float64, Float64}
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Generic Proportional/Integral Excitation System

Arguments

  • Tr::Float64: Regulator input filter time constant in s, validation range: (0, 0.5)
  • Ka::Float64: Voltage regulator gain, validation range: (1, 500)
  • Ta::Float64: Voltage regulator time constant in s, validation range: (0, 10)
  • Va_lim::MinMax: Limits for pi controler (Vr_min, Vr_max)
  • Ta_2::Float64: Voltage regulator time constant in s, validation range: (0, nothing)
  • Ta_3::Float64: Voltage regulator time constant in s, validation range: (0, nothing)
  • Ta_4::Float64: Voltage regulator time constant in s, validation range: (0, nothing)
  • Vr_lim::MinMax: Voltage regulator limits (regulator output) (Vimin, Vimax)
  • Kf::Float64: Rate feedback gain, validation range: (0, 0.3)
  • Tf_1::Float64: Rate Feedback time constant in s, validation range: (eps(), 15)
  • Tf_2::Float64: Rate Feedback time constant in s, validation range: (0, 5)
  • Efd_lim::MinMax: Field Voltage regulator limits (regulator output) (Efdmin, Efdmax)
  • Ke::Float64: Exciter constant, validation range: (0, 1)
  • Te::Float64: Exciter time constant, validation range: (0, 2)
  • E_sat::Tuple{Float64, Float64}: Exciter output voltage for saturation factor: (E1, E2)
  • Se::Tuple{Float64, Float64}: Exciter saturation factor at exciter output voltage: (Se(E1), Se(E2))
  • Kp::Float64: Potential source gain, validation range: (0, 5)
  • Ki::Float64: current source gain, validation range: (0, 1.1)
  • Kc::Float64: Exciter regulation factor, validation range: (0, 2)
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: (default: PowerSystems.get_avr_saturation(E_sat, Se)) (Do not modify.) Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vm: Sensed terminal voltage,
Vr1: First Lead-lag state,
Vr2: Second regulator lead-lag state,
Vr2: Third regulator lead-lag state 
Vf: Exciter output 
Vr3: First feedback integrator,
Vr4: second feedback integrator
  • n_states::Int: (Do not modify.) EXPIC1 has 6 states
  • states_types::Vector{StateTypes}: (Do not modify.) EXPIC has 6 states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

IEEET1

PowerSystems.IEEET1Type
mutable struct IEEET1 <: AVR
    Tr::Float64
    Ka::Float64
    Ta::Float64
    Vr_lim::MinMax
    Ke::Float64
    Te::Float64
    Kf::Float64
    Tf::Float64
    switch::Int
    E_sat::Tuple{Float64, Float64}
    Se::Tuple{Float64, Float64}
    V_ref::Float64
    saturation_coeffs::Tuple{Float64, Float64}
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

1968 IEEE type 1 excitation system model

Arguments

  • Tr::Float64: Voltage Measurement Time Constant in s, validation range: (0, 0.5)
  • Ka::Float64: Amplifier Gain, validation range: (10, 500)
  • Ta::Float64: Amplifier Time Constant in s, validation range: (0, 1)
  • Vr_lim::MinMax: Voltage regulator limits (regulator output) (Vimin, Vimax)
  • Ke::Float64: Exciter constant related to self-excited field, validation range: (-1, 1)
  • Te::Float64: Exciter time constant, integration rate associated with exciter control, validation range: (eps(), 1)
  • Kf::Float64: Excitation control system stabilizer gain, validation range: (eps(), 0.3)
  • Tf::Float64: Excitation control system stabilizer time constant. Appropiate Data: 5 <= Tf/Kf <= 15, validation range: (eps(), nothing)
  • switch::Int: Switch, validation range: (0, 1)
  • E_sat::Tuple{Float64, Float64}: Exciter output voltage for saturation factor: (E1, E2)
  • Se::Tuple{Float64, Float64}: Exciter saturation factor at exciter output voltage: (Se(E1), Se(E2))
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: (default: PowerSystems.get_avr_saturation(E_sat, Se)) (Do not modify.) Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vt: Terminal Voltage,
Vr: Regulator Output,
Vf: Exciter Output, 
Vr3: Rate feedback integrator
  • n_states::Int: (Do not modify.) The IEEET1 has 4 states
  • states_types::Vector{StateTypes}: (Do not modify.) IEEET1 I has 4 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

EX4VSA

EXST1

SCRX

PowerSystems.SCRXType
mutable struct SCRX <: AVR
    Ta_Tb::Float64
    Tb::Float64
    K::Float64
    Te::Float64
    Efd_lim::MinMax
    switch::Int
    rc_rfd::Float64
    V_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

This exciter is based on an IEEE type SCRX solid state exciter. The output field voltage is varied by a control system to maintain the system voltage at Vref. Please note that this exciter model has no initialization capabilities - this means that it will respond to whatever inputs it receives regardless of the state of the machine model

Arguments

  • Ta_Tb::Float64: Lead input constant ratio, validation range: (0.05, 0.3)
  • Tb::Float64: Lag input constant in s, validation range: (5, 20)
  • K::Float64: Regulator Gain, validation range: (20, 100)
  • Te::Float64: Regulator Time Constant, validation range: (0, 1)
  • Efd_lim::MinMax: Field Voltage regulator limits (regulator output) (Efdmin, Efdmax)
  • switch::Int: Switch, validation range: (0, 1)
  • rc_rfd::Float64: Field current capability. Set = 0 for negative current capability. Typical value 10, validation range: (0, 10)
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vr1: First integrator,
Vr2: Second integrator
  • n_states::Int: (Do not modify.) SCRX has 2 states
  • states_types::Vector{StateTypes}: (Do not modify.) SCRX has 2 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

SEXS

PowerSystems.SEXSType
mutable struct SEXS <: AVR
    Ta_Tb::Float64
    Tb::Float64
    K::Float64
    Te::Float64
    V_lim::MinMax
    V_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Parameters of Simplified Excitation System Model - SEXS in PSSE

Arguments

  • Ta_Tb::Float64: Ratio of lead and lag time constants, validation range: (0, nothing)
  • Tb::Float64: Lag time constant, validation range: (eps(), nothing)
  • K::Float64: Gain, validation range: (0, nothing)
  • Te::Float64: Field circuit time constant in s, validation range: (0, nothing)
  • V_lim::MinMax: Field voltage limits
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are: Vf: Voltage field, Vr: Lead-lag state
  • n_states::Int: (Do not modify.) SEXS has 2 states
  • states_types::Vector{StateTypes}: (Do not modify.) SEXS has 2 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

ST6B

PowerSystems.ST6BType
mutable struct ST6B <: AVR
    OEL_Flag::Int
    Tr::Float64
    K_pa::Float64
    K_ia::Float64
    K_da::Float64
    T_da::Float64
    Va_lim::MinMax
    K_ff::Float64
    K_m::Float64
    K_ci::Float64
    K_lr::Float64
    I_lr::Float64
    Vr_lim::MinMax
    Kg::Float64
    Tg::Float64
    V_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

In these excitation systems, voltage (and also current in compounded systems) is transformed to an appropriate level. Rectifiers, either controlled or non-controlled, provide the necessary direct current for the generator field. Parameters of IEEE Std 421.5 Type ST6B Excitacion System. ST6B in PSSE and PSLF

Arguments

  • OEL_Flag::Int: OEL Flag for ST6B: 1: before HV gate, 2: after HV gate, validation range: (0, 2)
  • Tr::Float64: Regulator input filter time constant in s, validation range: (0, nothing)
  • K_pa::Float64: Regulator proportional gain, validation range: (0, nothing)
  • K_ia::Float64: Regulator integral gain, validation range: (0, nothing)
  • K_da::Float64: Regulator derivative gain, validation range: (0, nothing)
  • T_da::Float64: Voltage regulator derivative channel time constant in s, validation range: (0, nothing)
  • Va_lim::MinMax: Regulator output limits (Vimin, Vimax)
  • K_ff::Float64: Pre-control gain of the inner loop field regulator, validation range: (0, nothing)
  • K_m::Float64: Forward gain of the inner loop field regulator, validation range: (0, nothing)
  • K_ci::Float64: Exciter output current limit adjustment gain, validation range: (0, nothing)
  • K_lr::Float64: Exciter output current limiter gain, validation range: (0, nothing)
  • I_lr::Float64: Exciter current limiter reference, validation range: (0, nothing)
  • Vr_lim::MinMax: Voltage regulator limits (Vimin, Vimax)
  • Kg::Float64: Feedback gain constant of the inner loop field regulator, validation range: (0, nothing)
  • Tg::Float64: Feedback time constant of the inner loop field voltage regulator in s, validation range: (0, nothing)
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vm: Sensed terminal voltage,
x_i: Regulator Integrator,
x_d: Regulator Derivative,
Vg: Regulator Feedback
  • n_states::Int: (Do not modify.) ST6B has 4 states
  • states_types::Vector{StateTypes}: (Do not modify.) ST6B has 4 states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

ST8C

PowerSystems.ST8CType
mutable struct ST8C <: AVR
    OEL_Flag::Int
    UEL_Flag::Int
    SCL_Flag::Int
    SW1_Flag::Int
    Tr::Float64
    K_pr::Float64
    K_ir::Float64
    Vpi_lim::MinMax
    K_pa::Float64
    K_ia::Float64
    Va_lim::MinMax
    K_a::Float64
    T_a::Float64
    Vr_lim::MinMax
    K_f::Float64
    T_f::Float64
    K_c1::Float64
    K_p::Float64
    K_i1::Float64
    X_l::Float64
    θ_p::Float64
    VB1_max::Float64
    K_c2::Float64
    K_i2::Float64
    VB2_max::Float64
    V_ref::Float64
    Ifd_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

In these excitation systems, voltage (and also current in compounded systems) is transformed to an appropriate level. Rectifiers, either controlled or non-controlled, provide the necessary direct current for the generator field. Parameters of IEEE Std 421.5 Type ST8C Excitacion System. ST8C in PSSE and PSLF

Arguments

  • OEL_Flag::Int: OEL Flag for ST8C: <2: Summation at Voltage Error, 2: OEL takeover at gate, validation range: (0, 2)
  • UEL_Flag::Int: UEL Flag for ST8C: <2: Summation at Voltage Error, 2: UEL takeover at gate, validation range: (0, 2)
  • SCL_Flag::Int: SCL Flag for ST8C: <2: Summation at Voltage Error, 2: SCL Takeover at UEL and OEL gates, validation range: (0, 2)
  • SW1_Flag::Int: SW1 Flag for Power Source Selector for ST8C: <2: Source from generator terminal voltage, 2: Independent power source, validation range: (0, 2)
  • Tr::Float64: Regulator input filter time constant in seconds, validation range: (0, nothing)
  • K_pr::Float64: Regulator proportional gain (pu), validation range: (0, nothing)
  • K_ir::Float64: Regulator integral gain (pu), validation range: (0, nothing)
  • Vpi_lim::MinMax: Regulator input limits (Vpimin, Vpimax)
  • K_pa::Float64: Field current regulator proportional gain (pu), validation range: (0, nothing)
  • K_ia::Float64: Field current regulator integral gain (pu), validation range: (0, nothing)
  • Va_lim::MinMax: Field current regulator output limits (Vamin, Vamax)
  • K_a::Float64: Field current regulator proportional gain (pu), validation range: (0, nothing)
  • T_a::Float64: Controlled rectifier bridge equivalent time constant in seconds, validation range: (0, nothing)
  • Vr_lim::MinMax: Voltage regulator limits (Vrmin, Vrmax)
  • K_f::Float64: Exciter field current feedback gain (pu), validation range: (0, nothing)
  • T_f::Float64: Field current feedback time constant in seconds, validation range: (0, nothing)
  • K_c1::Float64: Rectifier loading factor proportional to commutating reactance (pu), validation range: (0, nothing)
  • K_p::Float64: Potential circuit (voltage) gain coefficient (pu), validation range: (0, nothing)
  • K_i1::Float64: Potential circuit (current) gain coefficient (pu), validation range: (0, nothing)
  • X_l::Float64: Reactance associated with potential source (pu), validation range: (0, nothing)
  • θ_p::Float64: Potential circuit phase angle (degrees), validation range: (0, nothing)
  • VB1_max::Float64: Maximum available exciter voltage (pu), validation range: (0, nothing)
  • K_c2::Float64: Rectifier loading factor proportional to commutating reactance (pu), validation range: (0, nothing)
  • K_i2::Float64: Potential circuit (current) gain coefficient (pu), validation range: (0, nothing)
  • VB2_max::Float64: Maximum available exciter voltage (pu), validation range: (0, nothing)
  • V_ref::Float64: (default: 1.0) Reference Voltage Set-point (pu), validation range: (0, nothing)
  • Ifd_ref::Float64: (default: 1.0) Reference Field Current Set-point (pu), validation range: (0, nothing)
  • 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.
  • states::Vector{Symbol}: (Do not modify.) The states are:
Vm: Sensed terminal voltage,
x_a1: Regulator Integrator state,
x_a2: Field Current regulator state,
x_a3: Controller rectifier bridge state,
x_a4: Regulator Feedback state
  • n_states::Int: (Do not modify.) ST8C has 5 states
  • states_types::Vector{StateTypes}: (Do not modify.) ST8C has 5 states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source