modelSynchronousMachine4WindingsInternalParameters

Synchronous machine with 4 windings - internal parameters
Diagram of SynchronousMachine4WindingsInternalParameters

Extends from BaseClasses.OnePortACdqPU (Base class for one-port AC components with p.u. Park's transformation), Icons.Machine.

Information

Model of a sychronous machine with four windings. The transformer voltage terms are neglected if neglectTransformerTerms=true. The model parameters refer directly to internal physical parameters such as inductances and resistances.

The model is taken from the theory manual of the Eurostag software. For consistency with the base class OnePortACdq, however, the currents ifPu, idPu and iqPu are all assumed to be positive entering, while the Eurostag manual assumes them to be all positive leaving. Therefore, all the current and fluxes have an opposite sign in the Park equations.

This model is in fact equivalent to the model described in Kundur, Power Systems Stability and Control, Chapter 3, except for the current sign conventions, which in that case are assumed to be positive entering for the rotor winding and positive leaving for the direct and quadrature stator axes. The correspondance of the parameter symbols is given in the table, all parameters are in p.u. referred to the machine rated values.

PowerGridsKundurMeaning
raPuRaArmature resistance
rDPuR1dResistance of the direct axis damper
rfPuRfdResistance of the excitation windings
rQ1R1qResistance of the quadrature axis 1st damper
rQ2R2qResistance of the quadrature axis 2nd damper
MdPuLadDirect axis mutual inductance
MqPuLaqQuadrature axis mutual inductance
LdPuLlDirect axis stator leakage
LqPuLlQuadrature axis stator leakage
LDPuL1dDirect axis damper leakage
LQ1PuL1qQuadrature axis 1st damper leakage
LQ2PuL2qQuadrature axis 2nd damper leakage
LfPuLfdExcitation winding leakage
mrcPuLfld-LadCanay's mutual inductance

Two different choices of base excitation voltage are available

  • Types.ExcitationPuType.nominalStatorVoltageNoLoad: 1 p.u. of excitation voltage gives 1 p.u. of air-gap stator voltage at no-load conditions
  • Types.ExcitationPuType.Kundur: base voltage as in Kundur, Power Systems Stability and Control, Chapter 3. Note that in this case, typical p.u. values are less than 0.001

Parameters

TypeNameDefaultDescription
Types.VoltageUNom (from OnePortAC)Nominal/rated line-to-line voltage
Types.ApparentPowerSNom (from OnePortAC)Nominal/rated apparent power
BooleanportVariablesPhases (from OnePortAC)falseCompute voltage and current phases for monitoring purposes only
BooleanportVariablesPu (from OnePortAC)trueAdd per-unit variables to model
BooleangeneratorConvention (from OnePortAC)falseAdd currents with generator convention (i > 0 when exiting the device) to model
LocalInitializationOptionlocalInit (from OnePortAC)LocalInitializationOption.noneInitialize the component locally in steady state from port start values
SI.AnglethetaStart (from OnePortACdqPU)UPhaseStartStart value of rotation between machine rotor frame and port phasor frame
Types.PerUnitudPuStart (from OnePortACdqPU)Start value of udPu
Types.PerUnituqPuStart (from OnePortACdqPU)Start value of uqPu
Types.PerUnitidPuStart (from OnePortACdqPU)Start value of idPu
Types.PerUnitiqPuStart (from OnePortACdqPU)Start value of iqPu
Types.ActivePowerPNomSNomNominal active (turbine) power
Types.PerUnitraPuArmature resistance in p.u.
Types.PerUnitLdPuDirect axis stator leakage in p.u.
Types.PerUnitMdPuDirect axis mutual inductance in p.u.
Types.PerUnitmrcPuCanay's mutual inductance in p.u.
Types.PerUnitLDPuDirect axis damper leakage in p.u.
Types.PerUnitrDPuResistance of the direct axis damper in p.u.
Types.PerUnitLfPuExcitation winding leakage in p.u.
Types.PerUnitrfPuResistance of the excitation windings in p.u.
Types.PerUnitLqPuQuadrature axis stator leakage in p.u.
Types.PerUnitMqPuQuadrature axis mutual inductance in p.u.
Types.PerUnitLQ1PuQuadrature axis 1st damper leakage in p.u.
Types.PerUnitrQ1PuQuadrature axis 2nd damper leakage in p.u.
Types.PerUnitLQ2PuLeakage of quadrature axis 2nd damper in p.u.
Types.PerUnitrQ2PuResistance of quadrature axis 2nd damper in p.u.
Types.PerUnitDPu0Damping coefficient of the swing equation in p.u.
Modelica.SIunits.TimeHKinetic constant = kinetic energy / rated power
Types.Choices.ExcitationPuTypeexcitationPuTypePowerGrids.Types.Choices.ExcitationPuType.nominalStatorVoltageNoLoadChoice of excitation base voltage
BooleanneglectTransformerTermstrueNeglect the transformer terms in the Park equations
BooleanreferenceGeneratorfalseTrue if reference generator in an isolated synchronous system
Types.Choices.InitializationOptioninitOptsystemPowerGrids.initOptInitialization option
SI.AngularVelocityomegaBasesystemPowerGrids.omegaNomBase angular frequency value
Types.PerUnitkufScaling factor for excitation p.u. voltage
Types.PerUnitomegaNomPu1Nominal frequency in p.u.
Types.PerUnitlambdadPuStartStart value of lambdadPu
Types.PerUnitlambdaqPuStartStart value of lambdaqPu
Types.PerUnitufPuStartStart value of exciter voltage in p.u. (Kundur base)
Types.PerUnitufPuInStartStart value of input exciter voltage in p.u. (user-selcted base
Types.PerUnitifPuStartStart value of ifPu
Initialization
Types.VoltageUStart (from OnePortAC)UNomStart value of phase-to-phase voltage phasor, absolute value
Types.AngleUPhaseStart (from OnePortAC)0Start value of phase-to-phase voltage phasor, phase angle
Types.ActivePowerPStart (from OnePortAC)SNomStart value of active power flowing into the port
Types.ReactivePowerQStart (from OnePortAC)0Start value of reactive power flowing into the port

Connectors

TypeNameDefaultDescription
PowerGrids.Interfaces.TerminalACterminal (from OnePortAC)
Modelica.Blocks.Interfaces.RealInputPmPuInput mechanical power in p.u. (base PNom)
Modelica.Blocks.Interfaces.RealInputufPuInInput voltage of exciter winding in p.u. (user-selected base voltage)
Modelica.Blocks.Interfaces.RealOutputomegaAngular frequency in rad/s for system object
Modelica.Blocks.Interfaces.RealOutputomegaPuAngular frequency in p.u.
Modelica.Blocks.Interfaces.RealOutputVPuPort voltage magnitude [pu]
Modelica.Blocks.Interfaces.RealOutputPPuActive Power Production [pu base PNom]

Components

TypeNameDefaultDescription
PortACport (from OnePortAC)AC port of node
Electrical.SystemsystemPowerGrids (from OnePortAC)Reference to system object
Types.PerUnitudPu (from OnePortACdqPU)Voltage of direct axis in p.u.
Types.PerUnituqPu (from OnePortACdqPU)Voltage of quadrature axis in p.u.
Types.PerUnitidPu (from OnePortACdqPU)Current of direct axis in p.u.
Types.PerUnitiqPu (from OnePortACdqPU)Current of quadrature axis in p.u.
Types.Angletheta (from OnePortACdqPU)Rotation between machine rotor frame and port phasor frame
Types.PerUnitiDPuCurrent of direct axis damper in p.u
Types.PerUnitifPuCurrent of excitation winding in p.u.
Types.PerUnitiQ1PuCurrent of quadrature axis 1st damper in p.u.
Types.PerUnitiQ2PuCurrent of quadrature axis 2nd damper in p.u.
Types.PerUnitufPuVoltage of exciter winding in p.u. (base voltage as per Kundur)
Types.PerUnitlambdadPuFlux of direct axis in p.u.
Types.PerUnitlambdaqPuFlux of quadrature axis in p.u.
Types.PerUnitlambdaDPuFlux of direct axis damper in p.u
Types.PerUnitlambdafPuFlux of excitation winding in p.u.
Types.PerUnitlambdaQ1PuFlux of quadrature axis 1st damper in p.u.
Types.PerUnitlambdaQ2PuFlux of quadrature axis 1st damper in p.u.
Types.PerUnitomegaRefPusystemPowerGrids.omegaRef/systemPowerGrids.omegaNomReference frequency in p.u.
Types.PerUnitCmPuMechanical torque in p.u. (base PNom/omegaBase)
Types.PerUnitCePuElectrical torque in p.u. (base SNom/omegaBase)
Types.PerUnitPePuElectrical power in p.u. (base SNom)
Types.PerUnitPePuPNomPePu*SNom/PNomElectrical active power in p.u. (base PNom)
Types.FrequencyfsystemPowerGrids.fNom*omegaPuFrequency of rotation of d-q axes