GitHub

TurbineGov

DEGOV

PowerSystems.DEGOV — Type
mutable struct DEGOV <: TurbineGov
    T1::Float64
    T2::Float64
    T3::Float64
    K::Float64
    T4::Float64
    T5::Float64
    T6::Float64
    Td::Float64
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Parameters Woodward Diesel Governor Model. DEGOV in PowerWorld

Arguments

  • T1::Float64: Governor mechanism time constant, validation range: (eps(), 100)
  • T2::Float64: Turbine power time constant, validation range: (eps(), 100)
  • T3::Float64: Turbine exhaust temperature time constant, validation range: (eps(), 100)
  • K::Float64: Governor gain (reciprocal of droop), validation range: (eps(), 100)
  • T4::Float64: Governor lead time constant, validation range: (eps(), 100)
  • T5::Float64: Governor lag time constant, validation range: (eps(), 100)
  • T6::Float64: Actuator time constant, validation range: (eps(), 100)
  • Td::Float64: Engine time delay, validation range: (eps(), 100)
  • P_ref::Float64: (default: 1.0) Reference Load 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.
  • states::Vector{Symbol}: (Do not modify.) The states of the DEGOV model are:
x_ecb1: Electric control box 1,
x_ecb2: Electric control box 2,
x_a1: Actuator 1,
x_a2: Actuator 2,
x_a3: Actuator 3,
  • n_states::Int: (Do not modify.) DEGOV has 5 states
  • states_types::Vector{StateTypes}: (Do not modify.) DEGOV has 5 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

DEGOV1

PowerSystems.DEGOV1 — Type
mutable struct DEGOV1 <: TurbineGov
    droop_flag::Int
    T1::Float64
    T2::Float64
    T3::Float64
    K::Float64
    T4::Float64
    T5::Float64
    T6::Float64
    Td::Float64
    T_lim::Tuple{Float64, Float64}
    R::Float64
    Te::Float64
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    internal::InfrastructureSystemsInternal
end

Parameters Woodward Diesel Governor Model. DEGOV1 in PSSE

Arguments

  • droop_flag::Int: Droop control Flag. 0 for throttle feedback and 1 for electric power feedback, validation range: (0, 1)
  • T1::Float64: Governor mechanism time constant in s, validation range: (0, 100)
  • T2::Float64: Turbine power time constant in s, validation range: (0, 100)
  • T3::Float64: Turbine exhaust temperature time constant in s, validation range: (0, 100)
  • K::Float64: Governor gain for actuator, validation range: (0, 100)
  • T4::Float64: Governor lead time constant in s, validation range: (0, 100)
  • T5::Float64: Governor lag time constant in s, validation range: (0, 100)
  • T6::Float64: Actuator time constant in s, validation range: (0, 100)
  • Td::Float64: Engine time delay in s, validation range: (0, 100)
  • T_lim::Tuple{Float64, Float64}: Operational control limits on actuator (Tmin, Tmax)
  • R::Float64: Steady state droop parameter, validation range: (0, 100)
  • Te::Float64: Power transducer time constant in s, validation range: (0, 100)
  • P_ref::Float64: (default: 1.0) Reference Load 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.
  • states::Vector{Symbol}: (Do not modify.) The states of the DEGOV1 model depends on the droop flag
  • n_states::Int: (Do not modify.) The number of states of the DEGOV1 model depends on the droop flag
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

GasTG

PowerSystems.GasTG — Type
mutable struct GasTG <: TurbineGov
    R::Float64
    T1::Float64
    T2::Float64
    T3::Float64
    AT::Float64
    Kt::Float64
    V_lim::Tuple{Float64, Float64}
    D_turb::Float64
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Parameters of Gas Turbine-Governor. GAST in PSSE and GAST_PTI in PowerWorld

Arguments

  • R::Float64: Speed droop parameter, validation range: (eps(), 0.1)
  • T1::Float64: Governor time constant in s, validation range: (eps(), 0.5)
  • T2::Float64: Combustion chamber time constant, validation range: (eps(), 0.5)
  • T3::Float64: Load limit time constant (exhaust gas measurement time), validation range: (eps(), 5)
  • AT::Float64: Ambient temperature load limit, validation range: (0, 1)
  • Kt::Float64: Load limit feedback gain, validation range: (0, 5)
  • V_lim::Tuple{Float64, Float64}: Operational control limits on fuel valve opening (Vmin, Vmax)
  • D_turb::Float64: Speed damping coefficient of gas turbine rotor, validation range: (0, 0.5)
  • P_ref::Float64: (default: 1.0) Reference Load 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.
  • states::Vector{Symbol}: (Do not modify.) The states of the GAST model are:
x_g1: Fuel valve opening,
x_g2: Fuel flow,
x_g3: Exhaust temperature load
  • n_states::Int: (Do not modify.) GasTG has 3 states
  • states_types::Vector{StateTypes}: (Do not modify.) GAST has 3 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

GeneralGovModel

PowerSystems.GeneralGovModel — Type
mutable struct GeneralGovModel <: TurbineGov
    Rselect::Int
    fuel_flag::Int
    R::Float64
    Tpelec::Float64
    speed_error_signal::MinMax
    Kp_gov::Float64
    Ki_gov::Float64
    Kd_gov::Float64
    Td_gov::Float64
    valve_position_limits::MinMax
    T_act::Float64
    K_turb::Float64
    Wf_nl::Float64
    Tb::Float64
    Tc::Float64
    T_eng::Float64
    Tf_load::Float64
    Kp_load::Float64
    Ki_load::Float64
    Ld_ref::Float64
    Dm::Float64
    R_open::Float64
    R_close::Float64
    Ki_mw::Float64
    A_set::Float64
    Ka::Float64
    Ta::Float64
    T_rate::Float64
    db::Float64
    Tsa::Float64
    Tsb::Float64
    R_lim::UpDown
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

GE General Governor/Turbine Model. The GeneralGovModel (GGOV1) model is a general purpose governor model used for a variety of prime movers controlled by proportional-integral-derivative (PID) governors including gas turbines

Arguments

  • Rselect::Int: Feedback signal for governor droop, validation range: (-2, 1)
  • fuel_flag::Int: Flag Switch for fuel source characteristic, validation range: (0, 1)
  • R::Float64: Speed droop parameter, validation range: (eps(), nothing)
  • Tpelec::Float64: Electrical power transducer time constant, seconds, validation range: (eps(), nothing)
  • speed_error_signal::MinMax: Speed error signal limits
  • Kp_gov::Float64: Governor proportional gain, validation range: (0, nothing)
  • Ki_gov::Float64: Governor integral gain, validation range: (0, nothing)
  • Kd_gov::Float64: Governor derivative gain, validation range: (0, nothing)
  • Td_gov::Float64: Governor derivative time constant, validation range: (0, nothing)
  • valve_position_limits::MinMax: Valve position limits
  • T_act::Float64: Actuator time constant, validation range: (0, nothing)
  • K_turb::Float64: Turbine gain, validation range: (0, nothing)
  • Wf_nl::Float64: No load fuel flow, pu, validation range: (0, nothing)
  • Tb::Float64: Turbine lag time constant, sec, validation range: (0, nothing)
  • Tc::Float64: Turbine lead time constant, sec, validation range: (0, nothing)
  • T_eng::Float64: Transport lag time constant for diesel engine, sec, validation range: (0, nothing)
  • Tf_load::Float64: Load limiter time constant, validation range: (0, nothing)
  • Kp_load::Float64: Load limiter proportional gain for PI controller, validation range: (0, nothing)
  • Ki_load::Float64: Load integral gain for PI controller, validation range: (0, nothing)
  • Ld_ref::Float64: Load limiter integral gain for PI controller, validation range: (0, nothing)
  • Dm::Float64: Mechanical damping coefficient, pu, validation range: (0, nothing)
  • R_open::Float64: Maximum valve opening rate, pu/sec, validation range: (0, nothing)
  • R_close::Float64: Maximum valve closing rate, pu/sec, validation range: (0, nothing)
  • Ki_mw::Float64: Power controller (reset) gain, validation range: (0, nothing)
  • A_set::Float64: Acceleration limiter setpoint, pu/sec, validation range: (0, nothing)
  • Ka::Float64: Acceleration limiter gain, validation range: (0, nothing)
  • Ta::Float64: Acceleration limiter time constant , validation range: (eps(), nothing)
  • T_rate::Float64: Turbine rating, validation range: (0, nothing)
  • db::Float64: Speed governor deadband, validation range: (0, nothing)
  • Tsa::Float64: Temperature detection lead time constant, validation range: (0, nothing)
  • Tsb::Float64: Temperature detection lag time constant, validation range: (0, nothing)
  • R_lim::UpDown: Maximum rate of load increase
  • P_ref::Float64: (default: 1.0) Reference Power 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.
  • states::Vector{Symbol}: (Do not modify.) The states of the GGOV1 model are:
Pe: Machine Electrical Power Measurement,
x_g1: Governor differential control,
x_g2: Governor integral control, 
x_g3: Turbine actuator, 
x_g4: Turbine Lead-Lag, 
x_g5: Turbine load limiter measurement, 
x_g6: Turbine Load Limiter Integral Control, 
x_g7: Supervisory Load Control, 
x_g8: Acceleration Control, 
x_g9 Temperature Detection Lead - Lag:
  • n_states::Int: (Do not modify.) GeneralGovModel has 10 states
  • states_types::Vector{StateTypes}: (Do not modify.) GGOV1 has 10 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

HydroTurbineGov

PowerSystems.HydroTurbineGov — Type
mutable struct HydroTurbineGov <: TurbineGov
    R::Float64
    r::Float64
    Tr::Float64
    Tf::Float64
    Tg::Float64
    VELM::Float64
    gate_position_limits::MinMax
    Tw::Float64
    At::Float64
    D_T::Float64
    q_nl::Float64
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Hydro Turbine-Governor

Arguments

  • R::Float64: Permanent droop parameter, validation range: (0, 0.1)
  • r::Float64: Temporary Droop, validation range: (0, 2)
  • Tr::Float64: Governor time constant, validation range: (eps(), 30)
  • Tf::Float64: Filter Time constant, validation range: (eps(), 0.1)
  • Tg::Float64: Servo time constant, validation range: (eps(), 1)
  • VELM::Float64: gate velocity limit, validation range: (eps(), 0.3)
  • gate_position_limits::MinMax: Gate position limits
  • Tw::Float64: water time constant, validation range: (eps(), 3)
  • At::Float64: Turbine gain, validation range: (0.8, 1.5)
  • D_T::Float64: Turbine Damping, validation range: (0, 0.5)
  • q_nl::Float64: No-power flow, validation range: (0, nothing)
  • P_ref::Float64: (default: 1.0) Reference Power 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.
  • states::Vector{Symbol}: (Do not modify.) The states of the HydroTurbineGov model are:
x_g1: filter_output,
x_g2: desired gate, 
x_g3: gate opening, 
x_g4: turbine flow
  • n_states::Int: (Do not modify.) HYGOV has 4 states
  • states_types::Vector{StateTypes}: (Do not modify.) HYGOV has 4 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

IEEETurbineGov1

PowerSystems.IEEETurbineGov1 — Type
mutable struct IEEETurbineGov1 <: TurbineGov
    K::Float64
    T1::Float64
    T2::Float64
    T3::Float64
    U0::Float64
    U_c::Float64
    valve_position_limits::MinMax
    T4::Float64
    K1::Float64
    K2::Float64
    T5::Float64
    K3::Float64
    K4::Float64
    T6::Float64
    K5::Float64
    K6::Float64
    T7::Float64
    K7::Float64
    K8::Float64
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

IEEE Type 1 Speed-Governing Model

Arguments

  • K::Float64: Governor Gain, validation range: (5, 30)
  • T1::Float64: Input Filter Lag, validation range: (0, 5)
  • T2::Float64: Input Filter Lead, validation range: (0, 10)
  • T3::Float64: Valve position Time Constant, validation range: (eps(), 1)
  • U0::Float64: Maximum Valve Opening Rate, validation range: (0.01, 0.03)
  • U_c::Float64: Maximum Valve closing rate, validation range: (-0.3, 0)
  • valve_position_limits::MinMax: Valve position limits in MW
  • T4::Float64: Time Constant inlet steam, validation range: (0, 1)
  • K1::Float64: Fraction of high presure shaft power, validation range: (-2, 1)
  • K2::Float64: Fraction of low presure shaft power, validation range: (0, nothing)
  • T5::Float64: Time constant for second boiler pass, validation range: (0, 10)
  • K3::Float64: Fraction of high presure shaft power second boiler pass, validation range: (0, 0.5)
  • K4::Float64: Fraction of low presure shaft power second boiler pass, validation range: (0, 0.5)
  • T6::Float64: Time constant for third boiler pass, validation range: (0, 10)
  • K5::Float64: Fraction of high presure shaft power third boiler pass, validation range: (0, 0.35)
  • K6::Float64: Fraction of low presure shaft power third boiler pass, validation range: (0, 0.55)
  • T7::Float64: Time constant for fourth boiler pass, validation range: (0, 10)
  • K7::Float64: Fraction of high presure shaft power fourth boiler pass, validation range: (0, 0.3)
  • K8::Float64: Fraction of low presure shaft power fourth boiler pass, validation range: (0, 0.3)
  • P_ref::Float64: (default: 1.0) Reference Power 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.
  • states::Vector{Symbol}: (Do not modify.) The states of the IEEETurbineGov model are:
x_g1: First Governor integrator,
x_g2: Governor output,
x_g3: First Turbine integrator, 
x_g4: Second Turbine Integrator, 
x_g5: Third Turbine Integrator, 
x_g6: Fourth Turbine Integrator,
  • n_states::Int: (Do not modify.) IEEEG1 has 6 states
  • states_types::Vector{StateTypes}: (Do not modify.) IEEEG1 has 6 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

PIDGOV

PowerSystems.PIDGOV — Type
mutable struct PIDGOV <: TurbineGov
    feedback_flag::Int
    Rperm::Float64
    T_reg::Float64
    Kp::Float64
    Ki::Float64
    Kd::Float64
    Ta::Float64
    Tb::Float64
    D_turb::Float64
    gate_openings::Tuple{Float64, Float64, Float64}
    power_gate_openings::Tuple{Float64, Float64, Float64}
    G_lim::MinMax
    A_tw::Float64
    Tw::Float64
    V_lim::MinMax
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Hydro Turbine-Governor with PID controller.

Arguments

  • feedback_flag::Int: Feedback signal for governor droop: 0 for electrical power, and 1 for gate position., validation range: (0, 1)
  • Rperm::Float64: Speed permanent droop parameter, validation range: (0, nothing)
  • T_reg::Float64: Speed detector time constant, validation range: (0, nothing)
  • Kp::Float64: Governor proportional gain, validation range: (0, nothing)
  • Ki::Float64: Governor integral gain, validation range: (0, nothing)
  • Kd::Float64: Governor derivative gain, validation range: (0, nothing)
  • Ta::Float64: Governor derivative time constant, validation range: (0, nothing)
  • Tb::Float64: Gate-servo time constant, validation range: (0, nothing)
  • D_turb::Float64: Turbine damping factor, validation range: (0, nothing)
  • gate_openings::Tuple{Float64, Float64, Float64}: Gate-opening speed at different loads
  • power_gate_openings::Tuple{Float64, Float64, Float64}: Power at gate_openings
  • G_lim::MinMax: Minimum/Maximum Gate openings (G_min, G_max).
  • A_tw::Float64: Factor multiplying Tw, validation range: (eps(), nothing)
  • Tw::Float64: Water inertia time constant, sec, validation range: (eps(), nothing)
  • V_lim::MinMax: Gate opening velocity limits (G_min, G_max).
  • P_ref::Float64: (default: 1.0) Reference Power 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.
  • states::Vector{Symbol}: (Do not modify.) The states of the PIDGOV model are:
x_g1: Filtered input measurement,
x_g2: PI block internal state,
x_g3: First regulator state, 
x_g4: Derivative block internal state, 
x_g5: Second regulator state, 
x_g6: Gate position state, 
x_g7: Water inertia state
  • n_states::Int: (Do not modify.) PIDGOV has 7 states
  • states_types::Vector{StateTypes}: (Do not modify.) PIDGOV has 7 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

SteamTurbineGov1

PowerSystems.SteamTurbineGov1 — Type
mutable struct SteamTurbineGov1 <: TurbineGov
    R::Float64
    T1::Float64
    valve_position_limits::MinMax
    T2::Float64
    T3::Float64
    D_T::Float64
    DB_h::Float64
    DB_l::Float64
    T_rate::Float64
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Steam Turbine-Governor. This model considers both TGOV1 or TGOV1DU in PSS/E

Arguments

  • R::Float64: Droop parameter, validation range: (0, 0.1)
  • T1::Float64: Governor time constant, validation range: (eps(), 0.5)
  • valve_position_limits::MinMax: Valve position limits
  • T2::Float64: Lead Lag Lead Time constant , validation range: (0, nothing)
  • T3::Float64: Lead Lag Lag Time constant , validation range: (eps(), 10)
  • D_T::Float64: Turbine Damping, validation range: (0, 0.5)
  • DB_h::Float64: Deadband for overspeed, validation range: (0, nothing)
  • DB_l::Float64: Deadband for underspeed, validation range: (nothing, 0)
  • T_rate::Float64: Turbine Rate (MW). If zero, generator base is used, validation range: (0, nothing)
  • P_ref::Float64: (default: 1.0) Reference Power 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.
  • states::Vector{Symbol}: (Do not modify.) The states of the SteamTurbineGov1 model are:
x_g1: Valve Opening,
x_g2: Lead-lag state
  • n_states::Int: (Do not modify.) TGOV1 has 2 states
  • states_types::Vector{StateTypes}: (Do not modify.) TGOV1 has 2 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

TGFixed

PowerSystems.TGFixed — Type
mutable struct TGFixed <: TurbineGov
    efficiency::Float64
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    internal::InfrastructureSystemsInternal
end

Parameters of a fixed Turbine Governor that returns a fixed mechanical torque given by the product of P_ref*efficiency

Arguments

  • efficiency::Float64: Efficiency factor that multiplies P_ref, validation range: (0, nothing)
  • P_ref::Float64: (default: 1.0) Reference Power 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.
  • states::Vector{Symbol}: (Do not modify.) TGFixed has no states
  • n_states::Int: (Do not modify.) TGFixed has no states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

TGSimple

PowerSystems.TGSimple — Type
mutable struct TGSimple <: TurbineGov
    d_t::Float64
    Tm::Float64
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    internal::InfrastructureSystemsInternal
end

Parameters of a Simple one-state Turbine Governor

Arguments

  • d_t::Float64: Inverse Droop parameter, validation range: (0, nothing)
  • Tm::Float64: Turbine Governor Low-Pass Time Constant [s], validation range: (0, nothing)
  • P_ref::Float64: (default: 1.0) Reference Power 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.
  • states::Vector{Symbol}: (Do not modify.) The states of the TGSimple model are:
τm: mechanical torque
  • n_states::Int: (Do not modify.) TGSimple has 1 state
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

TGTypeI

PowerSystems.TGTypeI — Type
mutable struct TGTypeI <: TurbineGov
    R::Float64
    Ts::Float64
    Tc::Float64
    T3::Float64
    T4::Float64
    T5::Float64
    valve_position_limits::MinMax
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    internal::InfrastructureSystemsInternal
end

Parameters of a Turbine Governor Type I

Arguments

  • R::Float64: Droop parameter, validation range: (0, nothing)
  • Ts::Float64: Governor time constant, validation range: (0, nothing)
  • Tc::Float64: Servo time constant, validation range: (0, nothing)
  • T3::Float64: Transient gain time constant, validation range: (0, nothing)
  • T4::Float64: Power fraction time constant, validation range: (0, nothing)
  • T5::Float64: Reheat time constant, validation range: (0, nothing)
  • valve_position_limits::MinMax: Valve position limits in MW
  • P_ref::Float64: (default: 1.0) Reference Power 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.
  • states::Vector{Symbol}: (Do not modify.) The states of the TGTypeI model are:
x_g1: Governor state,
x_g2: Servo state,
x_g3: Reheat state
  • n_states::Int: (Do not modify.) TGTypeI has 3 states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

TGTypeII

PowerSystems.TGTypeII — Type
mutable struct TGTypeII <: TurbineGov
    R::Float64
    T1::Float64
    T2::Float64
    τ_limits::MinMax
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    internal::InfrastructureSystemsInternal
end

Parameters of a Turbine Governor Type II

Arguments

  • R::Float64: Droop parameter, validation range: (0, nothing)
  • T1::Float64: Transient gain time constant, validation range: (0, nothing)
  • T2::Float64: Power fraction time constant, validation range: (0, nothing)
  • τ_limits::MinMax: Power into the governor limits
  • P_ref::Float64: (default: 1.0) Reference Power 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.
  • states::Vector{Symbol}: (Do not modify.) The states of the TGTypeI model are:
x_g1: lead-lag state
  • n_states::Int: (Do not modify.) TGTypeII has 1 state
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source

WPIDHY

PowerSystems.WPIDHY — Type
mutable struct WPIDHY <: TurbineGov
    T_reg::Float64
    reg::Float64
    Kp::Float64
    Ki::Float64
    Kd::Float64
    Ta::Float64
    Tb::Float64
    V_lim::MinMax
    G_lim::MinMax
    Tw::Float64
    P_lim::MinMax
    D::Float64
    gate_openings::Tuple{Float64, Float64, Float64}
    power_gate_openings::Tuple{Float64, Float64, Float64}
    P_ref::Float64
    ext::Dict{String, Any}
    states::Vector{Symbol}
    n_states::Int
    states_types::Vector{StateTypes}
    internal::InfrastructureSystemsInternal
end

Woodward PID Hydro Governor

Arguments

  • T_reg::Float64: Input time constant of the governor in s, validation range: (0, nothing)
  • reg::Float64: Input governor gain, validation range: (0, nothing)
  • Kp::Float64: Governor proportional gain, validation range: (0, nothing)
  • Ki::Float64: Governor integral gain, validation range: (0, nothing)
  • Kd::Float64: Governor derivative gain, validation range: (0, nothing)
  • Ta::Float64: Governor derivative/high-frequency time constant, validation range: (0, nothing)
  • Tb::Float64: Gate-servo time constant, validation range: (0, nothing)
  • V_lim::MinMax: Gate opening velocity limits (G_min, G_max).
  • G_lim::MinMax: Minimum/Maximum Gate velocity (G_min, G_max).
  • Tw::Float64: Water inertia time constant, sec, validation range: (eps(), nothing)
  • P_lim::MinMax: Minimum/Maximum Gate openings (P_min, P_max).
  • D::Float64: Turbine damping coefficient, validation range: (0, nothing)
  • gate_openings::Tuple{Float64, Float64, Float64}: Gate-opening speed at different loads
  • power_gate_openings::Tuple{Float64, Float64, Float64}: Power at gate_openings
  • P_ref::Float64: (default: 1.0) Reference Power 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.
  • states::Vector{Symbol}: (Do not modify.) The states of the PIDGOV model are:
x_g1: Filtered input measurement,
x_g2: PI block internal state,
x_g3: First regulator state, 
x_g4: Derivative block internal state, 
x_g5: Second regulator state, 
x_g6: Gate position state, 
x_g7: Water inertia state
  • n_states::Int: (Do not modify.) PIDGOV has 7 states
  • states_types::Vector{StateTypes}: (Do not modify.) PIDGOV has 7 differential states
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source