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 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 excitacion 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. Although this has a default, in almost all cases base_power should be updated to equal the base_power field of the StaticInjection device that this dynamic generator will be attached to.
  • n_states::Int: (Do not modify.) Number of states (will depend on the inputs above).
  • states::Vector{Symbol}: (Do not modify.) Vector of states (will depend on the inputs above).
  • ext::Dict{String, Any}: (default: Dict{String, Any}()) An extra dictionary for users to add metadata that are not used in simulation
  • internal::InfrastructureSystemsInternal: (Do not modify.) PowerSystems.jl internal reference
source