Signal Models

Controllers, regulators, generators and decoupling elements in the Signal namespace.

Signal models live in CPS::Signal and are domain independent: the same controller drives a dynamic phasor or an electromagnetic transient machine model, because it operates on scalar signals rather than on network quantities. The exception is the decoupling group, which exists per domain since it inserts real components into the network.

Excitation systems

Regulate generator terminal voltage by acting on field voltage. Equations and block diagrams are on the regulators page.

ModelDescription
ExciterDC1Standard IEEE type DC1 exciter
ExciterDC1SimpSimplified version of the IEEE type DC1 exciter
ExciterST1SimpSimplified static exciter
ExciterStaticStatic exciter, with an anti-windup strategy for the integral component

Power system stabiliser

ModelDescription
PSS1ASimplified IEEE PSS1A. Enhances damping of electromechanical oscillations, accepting rotor speed, active power and terminal voltage magnitude as optional inputs. Its output feeds the exciter

Turbines and governors

Governors set mechanical power from speed deviation; turbine models convert that into the torque applied to the machine.

ModelDescription
SteamTurbineSteam turbine, used in series with its governor
SteamTurbineGovernorGovernor for the steam turbine, instantiated separately from it
HydroTurbineHydro turbine, used in series with its governor
HydroTurbineGovernorGovernor for the hydro turbine, instantiated separately from it
TurbineGovernorType1Turbine and governor combined in one component
TurbineGovernorTurbine and governor combined in one component

Converter control

Control loops for the averaged inverter models. See power electronics for how these attach to the converter.

ModelDescription
PowerControllerVSIPower control loop used by the averaged grid-following inverter models
VoltageControllerVSIVoltage control loop used by the grid-forming inverter models
PLLPhase-locked loop
VCOVoltage-controlled oscillator

Signal generators

Drive sources and setpoints from a prescribed waveform rather than a constant.

ModelDescription
SignalGeneratorBase class for the generators below
SineWaveGeneratorSine wave
CosineFMGeneratorFrequency-modulated cosine
FrequencyRampGeneratorFrequency ramp
DCGeneratorConstant value

Filters and maths

ModelDescription
FIRFilterFinite impulse response filter
IntegratorIntegrator block used inside the control models

Decoupling

Split a network into parts that can be solved separately, either across solvers or across simulators in a co-simulation. See co-simulation.

ModelDomains
DecouplingLineDP::Ph1
DecouplingLineEMTEMT::Ph1
DecouplingLineEMT_Ph3EMT::Ph3
DecouplingIdealTransformerDP::Ph1, EMT::Ph1, EMT::Ph3, SP::Ph1

References