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, validation range: (0, nothing)
  • V_ref::Float64: Reference Voltage Set-point, validation range: (0, nothing)
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: Fixed AVR has no states
  • n_states::Int: Fixed AVR has no states
  • states_types::Vector{StateTypes}: Fixed AVR has no states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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: Reference Voltage Set-point, validation range: (0, nothing)
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: The states are:
Vf: field voltage
  • n_states::Int: Fixed AVR has 1 states
  • states_types::Vector{StateTypes}: Simple AVR has 1 differential states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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: Reference Voltage Set-point, validation range: (0, nothing)
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: The states are:
Vf: Voltage field,
Vr1: Amplifier State,
Vr2: Stabilizing Feedback State,
Vm: Measured voltage
  • n_states::Int: The AVR Type I has 4 states
  • states_types::Vector{StateTypes}: AVR Type I has 4 differential states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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: Reference Voltage Set-point, validation range: (0, nothing)
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: The states are:
Vf: Voltage field,
Vr1: First Lead-Lag state,
Vr2: Second lead-lag state,
Vm: Measured voltage
  • n_states::Int: AVR Type II has 4 states
  • states_types::Vector{StateTypes}: AVR Type II has 4 differential states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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), action if invalid: warn
  • Tb::Float64: Regulator denominator (lag) time constant in s, validation range: (0, 20), action if invalid: warn
  • Tc::Float64: Regulator numerator (lead) time constant in s, validation range: (0, 20), action if invalid: warn
  • Ka::Float64: Regulator output gain, validation range: (0, 1000), action if invalid: warn
  • 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), action if invalid: error
  • Kf::Float64: Rate feedback excitation system stabilizer gain, validation range: (0, 0.3), action if invalid: warn
  • Tf::Float64: Rate feedback time constant, validation range: (eps(), 1.5), action if invalid: error
  • Kc::Float64: Rectifier loading factor proportional to commutating reactance, validation range: (0, 1), action if invalid: warn
  • Kd::Float64: Demagnetizing factor, function of exciter alternator reactances, validation range: (0, 1), action if invalid: warn
  • Ke::Float64: Exciter field proportional constant, validation range: (0, 1), action if invalid: warn
  • 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: Reference Voltage Set-point, validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: Coefficients (A,B) of the function: Se(x) = B(x - A)^2/x
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: 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: ESAC1A has 5 states
  • states_types::Vector{StateTypes}: ESAC1A has 5 states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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), action if invalid: warn
  • Ka::Float64: Regulator output gain, validation range: (0, 1000), action if invalid: warn
  • Ta::Float64: Regulator output lag time constant in s, validation range: (0, 10), action if invalid: warn
  • Tk::Float64: Voltage Regulator lead time constant, validation range: (0, 10), action if invalid: warn
  • Tb::Float64: Regulator denominator (lag) time constant in s, validation range: (0, 20), action if invalid: warn
  • Tc::Float64: Regulator numerator (lead) time constant in s, validation range: (0, 20), action if invalid: warn
  • 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), action if invalid: error
  • VFE_lim::Float64: Exciter field current limiter reference, validation range: (-5, 20), action if invalid: warn
  • Kh::Float64: Exciter field current regulator feedback gain, validation range: (0, 100), action if invalid: warn
  • VH_max::Float64: Exciter field current limiter maximum output, validation range: (0, 100), action if invalid: warn
  • 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), action if invalid: warn
  • 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), action if invalid: warn
  • Ke::Float64: Exciter field proportional constant, validation range: (0, 2), action if invalid: warn
  • 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: Reference Voltage Set-point, validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: 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: ESAC6A has 5 states
  • states_types::Vector{StateTypes}: ESAC6A has 5 states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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), action if invalid: warn
  • Ka::Float64: Amplifier Gain, validation range: (10, 500), action if invalid: warn
  • Ta::Float64: Amplifier Time Constant in s, validation range: (0, 1), action if invalid: warn
  • Tb::Float64: Regulator input Time Constant in s, validation range: (0, nothing), action if invalid: warn
  • Tc::Float64: Regulator input Time Constant in s, validation range: (0, nothing), action if invalid: warn
  • 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), action if invalid: error
  • Kf::Float64: Excitation control system stabilizer gain, validation range: (eps(), 0.3), action if invalid: error
  • Tf::Float64: Excitation control system stabilizer time constant, validation range: (eps(), nothing), action if invalid: error
  • switch::Int: Switch, validation range: (0, 1), action if invalid: error
  • 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: Reference Voltage Set-point, validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: The states are:
Vt: Terminal Voltage,
Vr1: input lead lag,
Vr2: Regulator Output,
Vf: Exciter Output, 
Vr3: Rate feedback integrator
  • n_states::Int: The ESDC1A has 5 states
  • states_types::Vector{StateTypes}: ESDC1A has 5 differential states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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), action if invalid: warn
  • Ka::Float64: Amplifier Gain, validation range: (10, 500), action if invalid: warn
  • Ta::Float64: Amplifier Time Constant in s, validation range: (0, 1), action if invalid: warn
  • Tb::Float64: Regulator input Time Constant in s, validation range: (0, nothing), action if invalid: warn
  • Tc::Float64: Regulator input Time Constant in s, validation range: (0, nothing), action if invalid: warn
  • Vr_lim::MinMax: Voltage regulator limits (regulator output) (Vimin, Vimax)
  • Ke::Float64: Exciter constant related to self-excited field, validation range: (-1, 1), action if invalid: warn
  • Te::Float64: Exciter time constant, integration rate associated with exciter control, validation range: (eps(), 2), action if invalid: error
  • Kf::Float64: Excitation control system stabilizer gain, validation range: (0, 0.3), action if invalid: warn
  • Tf::Float64: Excitation control system stabilizer time constant. Appropiate Data: 5.0 <= Tf/Kf <= 15.0, validation range: (eps(), 1.5), action if invalid: error
  • switch::Int: Switch, validation range: (0, 1), action if invalid: error
  • 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: Reference Voltage Set-point, validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: The states are:
Vt: Terminal Voltage,
Vr1: input lead lag,
Vr2: Regulator Output,
Vf: Exciter Output, 
Vr3: Rate feedback integrator
  • n_states::Int: The ESDC2A has 5 states
  • states_types::Vector{StateTypes}: ESDC2A has 5 differential states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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), action if invalid: warn
  • 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), action if invalid: warn
  • 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), action if invalid: warn
  • 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), action if invalid: warn
  • Tb1::Float64: Second regulator denominator (lead) time constant in s, validation range: (0, 20), action if invalid: warn
  • Ka::Float64: Voltage regulator gain, validation range: (50, 1000), action if invalid: warn
  • Ta::Float64: Voltage regulator time constant in s, validation range: (0, 0.5), action if invalid: warn
  • 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), action if invalid: warn
  • Kf::Float64: Rate feedback gain, validation range: (0, 0.3), action if invalid: warn
  • Tf::Float64: Rate feedback time constant in s, validation range: (eps(), 1.5), action if invalid: error
  • K_lr::Float64: Exciter output current limiter gain, validation range: (0, 5), action if invalid: warn
  • I_lr::Float64: Exciter output current limit reference, validation range: (0, 5), action if invalid: warn
  • V_ref::Float64: Reference Voltage Set-point, validation range: (0, nothing)
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: 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: ST1A has 5 states
  • states_types::Vector{StateTypes}: ST1A has 5 states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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), action if invalid: warn
  • K_pr::Float64: Regulator propotional gain, validation range: (0, 75), action if invalid: warn
  • K_ir::Float64: Regulator integral gain, validation range: (0, 75), action if invalid: warn
  • Vr_lim::MinMax: Voltage regulator limits (Vimin, Vimax)
  • Ta::Float64: Voltage regulator time constant in s, validation range: (0, 1), action if invalid: warn
  • K_pm::Float64: Voltage regulator proportional gain output, validation range: (0, 1.2), action if invalid: warn
  • K_im::Float64: Voltage regulator integral gain output, validation range: (0, 18), action if invalid: warn
  • 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), action if invalid: warn
  • Kp::Float64: Potential circuit (voltage) gain coefficient, validation range: (0, 10), action if invalid: warn
  • Ki::Float64: Compound circuit (current) gain coefficient, validation range: (0, 1.1), action if invalid: warn
  • VB_max::Float64: Maximum available exciter voltage, validation range: (1, 20), action if invalid: warn
  • Kc::Float64: Rectifier loading factor proportional to commutating reactance, validation range: (0, 1), action if invalid: warn
  • Xl::Float64: Reactance associated with potential source, validation range: (0, 0.5), action if invalid: warn
  • θp::Float64: Potential circuit phase angle (degrees), validation range: (-90, 90), action if invalid: error
  • V_ref::Float64: Reference Voltage Set-point, validation range: (0, nothing)
  • θp_rad::Float64: Potential circuit phase angle (radians)
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: The states are:
Vm: Sensed terminal voltage,
Vt: Sensed Terminal Voltage,
Vr1: Regulator Integrator,
Vr2: Regulator Output,
Vm: Output integrator
  • n_states::Int: ST4B has 4 states
  • states_types::Vector{StateTypes}: ST4B has 4 states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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), action if invalid: warn
  • Tb::Float64: Regulator denominator (lag) time constant in s, validation range: (0, 20), action if invalid: warn
  • Tc::Float64: Regulator numerator (lead) time constant in s, validation range: (0, 20), action if invalid: warn
  • Ka::Float64: Regulator output gain, validation range: (0, 1000)
  • Ta::Float64: Regulator output time constant in s, validation range: (0, 10), action if invalid: warn
  • Vr_lim::MinMax: Limits for regulator output (Vr_min, Vr_max)
  • Te::Float64: Exciter field time constant in s, validation range: (eps(), 2), action if invalid: error
  • Kf::Float64: Rate feedback excitation system stabilizer gain, validation range: (0, 0.3), action if invalid: warn
  • Tf::Float64: Rate feedback time constant, validation range: (eps(), 1.5), action if invalid: error
  • 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), action if invalid: warn
  • Ke::Float64: Exciter field proportional constant, validation range: (0, 1), action if invalid: warn
  • 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: Reference Voltage Set-point, validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: 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: EXAC1 has 5 states
  • states_types::Vector{StateTypes}: EXAC1 has 5 states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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), action if invalid: warn
  • Tb::Float64: Regulator denominator (lag) time constant in s, validation range: (0, 20), action if invalid: warn
  • Tc::Float64: Regulator numerator (lead) time constant in s, validation range: (0, 20), action if invalid: warn
  • Ka::Float64: Regulator output gain, validation range: (0, 1000), action if invalid: warn
  • 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), action if invalid: error
  • Kf::Float64: Rate feedback excitation system stabilizer gain, validation range: (0, 0.3), action if invalid: warn
  • Tf::Float64: Rate feedback time constant, validation range: (eps(), 1.5), action if invalid: error
  • Kc::Float64: Rectifier loading factor proportional to commutating reactance, validation range: (0, 1), action if invalid: warn
  • Kd::Float64: Demagnetizing factor, function of exciter alternator reactances, validation range: (0, 1), action if invalid: warn
  • 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: Reference Voltage Set-point, validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: Coefficients (A,B) of the function: Se(x) = B(x - A)^2/x
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: 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: EXAC1A has 5 states
  • states_types::Vector{StateTypes}: EXAC1A has 5 states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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), action if invalid: warn
  • Tb::Float64: Regulator denominator (lag) time constant in s, validation range: (0, 20), action if invalid: warn
  • Tc::Float64: Regulator numerator (lead) time constant in s, validation range: (0, 20), action if invalid: warn
  • Ka::Float64: Regulator output gain, validation range: (0, 1000)
  • Ta::Float64: Regulator output time constant in s, validation range: (0, 10), action if invalid: warn
  • Va_lim::MinMax: Limits for regulator output (Va_min, Va_max)
  • Kb::Float64: Second Stage regulator gain, validation range: (eps(), 500), action if invalid: error
  • Vr_lim::MinMax: Limits for exciter field voltage (Vr_min, Vr_max)
  • Te::Float64: Exciter field time constant, validation range: (eps(), 2), action if invalid: error
  • Kl::Float64: Exciter field current limiter gain, validation range: (0, 1.1), action if invalid: warn
  • Kh::Float64: Exciter field current regulator feedback gain, validation range: (0, 1.1), action if invalid: warn
  • Kf::Float64: Rate feedback excitation system stabilizer gain, validation range: (0, 0.3), action if invalid: warn
  • Tf::Float64: Rate feedback time constant, validation range: (eps(), nothing), action if invalid: error
  • Kc::Float64: Rectifier loading factor proportional to commutating reactance, validation range: (0, 1), action if invalid: warn
  • Kd::Float64: Demagnetizing factor, function of exciter alternator reactances, validation range: (0, 1), action if invalid: warn
  • Ke::Float64: Exciter field proportional constant, validation range: (0, 1), action if invalid: warn
  • V_lr::Float64: Maximum exciter field current, validation range: (0, nothing), action if invalid: warn
  • 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: Reference Voltage Set-point, validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: 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: EXAC2 has 5 states
  • states_types::Vector{StateTypes}: EXAC2 has 5 states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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), action if invalid: warn
  • Ka::Float64: Voltage regulator gain, validation range: (1, 500), action if invalid: warn
  • Ta::Float64: Voltage regulator time constant in s, validation range: (0, 10), action if invalid: warn
  • 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), action if invalid: warn
  • Ta_4::Float64: Voltage regulator time constant in s, validation range: (0, nothing), action if invalid: warn
  • Vr_lim::MinMax: Voltage regulator limits (regulator output) (Vimin, Vimax)
  • Kf::Float64: Rate feedback gain, validation range: (0, 0.3), action if invalid: warn
  • 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), action if invalid: warn
  • Efd_lim::MinMax: Field Voltage regulator limits (regulator output) (Efdmin, Efdmax)
  • Ke::Float64: Exciter constant, validation range: (0, 1), action if invalid: warn
  • Te::Float64: Exciter time constant, validation range: (0, 2), action if invalid: warn
  • 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), action if invalid: warn
  • Ki::Float64: current source gain, validation range: (0, 1.1)
  • Kc::Float64: Exciter regulation factor, validation range: (0, 2), action if invalid: warn
  • V_ref::Float64: Reference Voltage Set-point, validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: 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: EXPIC1 has 6 states
  • states_types::Vector{StateTypes}: EXPIC has 6 states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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), action if invalid: warn
  • Ka::Float64: Amplifier Gain, validation range: (10, 500), action if invalid: warn
  • Ta::Float64: Amplifier Time Constant in s, validation range: (0, 1), action if invalid: warn
  • 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), action if invalid: error
  • Kf::Float64: Excitation control system stabilizer gain, validation range: (eps(), 0.3), action if invalid: warn
  • Tf::Float64: Excitation control system stabilizer time constant. Appropiate Data: 5 <= Tf/Kf <= 15, validation range: (eps(), nothing), action if invalid: error
  • switch::Int: Switch, validation range: (0, 1), action if invalid: error
  • 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: Reference Voltage Set-point, validation range: (0, nothing)
  • saturation_coeffs::Tuple{Float64, Float64}: Coefficients (A,B) of the function: Se(V) = B(V - A)^2/V
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: The states are:
Vt: Terminal Voltage,
Vr: Regulator Output,
Vf: Exciter Output, 
Vr3: Rate feedback integrator
  • n_states::Int: The IEEET1 has 4 states
  • states_types::Vector{StateTypes}: IEEET1 I has 4 differential states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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), action if invalid: error
  • Tb::Float64: Lag input constant in s, validation range: (5, 20), action if invalid: error
  • K::Float64: Regulator Gain, validation range: (20, 100), action if invalid: warn
  • Te::Float64: Regulator Time Constant, validation range: (0, 1), action if invalid: warn
  • Efd_lim::MinMax: Field Voltage regulator limits (regulator output) (Efdmin, Efdmax)
  • switch::Int: Switch, validation range: (0, 1), action if invalid: error
  • rc_rfd::Float64: Field current capability. Set = 0 for negative current capability. Typical value 10, validation range: (0, 10), action if invalid: warn
  • V_ref::Float64: Reference Voltage Set-point, validation range: (0, nothing)
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: The states are:
Vr1: First integrator,
Vr2: Second integrator
  • n_states::Int: SCRX has 2 states
  • states_types::Vector{StateTypes}: SCRX has 2 differential states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
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: Reference Voltage Set-point, validation range: (0, nothing)
  • ext::Dict{String, Any}
  • states::Vector{Symbol}: The states are: Vf: Voltage field, Vr: Lead-lag state
  • n_states::Int: SEXS has 2 states
  • states_types::Vector{StateTypes}: SEXS has 2 differential states
  • internal::InfrastructureSystemsInternal: power system internal reference, do not modify
source