GitHub

DynamicGenerator

PowerSystems.DynamicGenerator — Type
mutable struct DynamicGenerator{
    M <: Machine,
    S <: Shaft,
    A <: AVR,
    TG <: TurbineGov,
    P <: PSS,
} <: DynamicInjection
    name::String
    ω_ref::Float64
    machine::M
    shaft::S
    avr::A
    prime_mover::TG
    pss::P
    base_power::Float64
    n_states::Int
    states::Vector{Symbol}
    ext::Dict{String, Any}
    internal::InfrastructureSystemsInternal
end

A dynamic generator with the necessary data for modeling the dynamic response of a generator in a phasor or electromagnetic transient simulation.

Dynamic generator is composed by 5 components, namely a Machine, a Shaft, an Automatic Voltage Regulator (AVR), a Prime Mover and Turbine Governor, and Power System Stabilizer (PSS). It must be attached to a StaticInjection device using add_component!, which contains all the rest of the generator's data that isn't specific to its dynamic response.

Arguments

  • name::String: Name of the generator

  • ω_ref::Float64: Frequency reference set-point in pu

  • machine::Machine: Machine model for modeling the electro-magnetic phenomena

  • shaft::Shaft: Shaft model for modeling the electro-mechanical phenomena

  • avr::AVR: AVR model of the excitation system

  • prime_mover::TurbineGov: Prime Mover and Turbine Governor model for mechanical power

  • pss::PSS: PSS model

  • base_power::Float64: (default: 100.0) Base power of the unit (MVA) for per unitization. In almost all cases, this should match the base_power of the attached StaticInjection device

  • n_states::Int64: (Do not modify.) Number of states (will depend on the components above)

  • states::Vector{Symbol}: (Do not modify.) Vector of states (will depend on the components above)

  • ext::Dict{String, Any}: (default: Dict{String, Any}()) An extra dictionary for users to add metadata that are not used in simulation

  • internal::InfrastructureSystems.InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference

source