modelEpriGFM

EPRI Grid Forming model

Extends from Parameters.CurrentControl (Current control parameters), Parameters.VoltageControl (Voltage control parameters), Parameters.Gfm (GFM parameters), Parameters.OmegaFlag (OmegaFlag parameter), Parameters.PLL.

Information

The Generic EPRI GFM model is implemented following the documentation on EPRI website: https://www.epri.com/research/products/000000003002021403.
It offers four control modes:
1 - Droop based, OmegaFlag = 1
2 - Virtual Synchronous Machine (VSM), OmegaFlag = 2
3 - Dispatchable Virtual Oscillator (dVOC) based GFM, OmegaFlag = 3
4- Phase Locked Loop (Grid following mode), OmegaFlag = 0

For more detail about the implementation see 
https://colib.net/pages/models/generations/Sources/epri_gfm/

Parameters

TypeNameDefaultDescription
CurrentControl
Types.PerUnitKPi (from CurrentControl)Proportional gain of the current loop, example value = 0.5
Types.PerUnitKIi (from CurrentControl)Integral gain of the current loop, example value = 5
Types.TimetE (from CurrentControl)PT1 constant for voltage output in s, example value = 0.01
VoltageControl
Types.PerUnitIMaxPu (from VoltageControl)Max current in pu (base UNom, SNom), example value = 1.05
Types.PerUnitKIp (from VoltageControl)Integral gain of the power loop, example value = 10
Types.PerUnitKIv (from VoltageControl)Integral gain of the voltage loop, example value = 150 if OmegaFlag=0 else 10
Types.PerUnitKPp (from VoltageControl)Proportional gain of the power loop, example value = 2
Types.PerUnitKPv (from VoltageControl)Proportional gain of the voltage loop, example value = 0.5 if OmegaFlag=0 else 2.0
Types.PerUnitOmegaDroopPu (from VoltageControl)Frequency droop in pu, example value = 0.05
BooleanPQFlag (from VoltageControl)Active or active power priority flag: false = P priority, true = Q priority
Types.PerUnitQDroopPu (from VoltageControl)Voltage droop in pu, example value = 0.2
Types.PerUnitUDipPu (from VoltageControl)Freeze voltage in pu (base UNom), example value = 0.85
GFM
Types.PerUnitDD (from Gfm)VSM damping factor, example value = 0.11
Types.PerUnitDeltaOmegaMaxPu (from Gfm)Frequency deviation maximum in pu/s (base omegaNom), example value = 75(rad/s)/omegaNom
Types.PerUnitDeltaOmegaMinPu (from Gfm)Frequency deviation minimum in pu/s (base omegaNom), example value = -75(rad/s)/omegaNom
Types.PerUnitK1 (from Gfm)Gain, set according to OmegaFlag
Types.PerUnitK2 (from Gfm)Gain, set according to OmegaFlag
Types.PerUnitK2Dvoc (from Gfm)Gain, set according to OmegaFlag
Types.PerUnitKD (from Gfm)Gain of the active damping, Set according to OmegaFlag
Types.PerUnitMF (from Gfm)VSM inertia constant, example value = 0.15
Types.TimetF (from Gfm)Time constant in s, set according to OmegaFlag
Types.TimetR (from Gfm)Transducer time constant in s, example value = 0.005
Types.TimetV (from Gfm)Time constant in s, set according to OmegaFlag
General
IntegerOmegaFlag (from OmegaFlag)GFM control type; 0=GFL, 1=droop, 2=VSM, 3=dVOC
Types.ApparentPowerModuleSNomNominal apparent power in MVA
Pll
Types.PerUnitKIPll (from PLL)PLL integrator gain, example value = 700
Types.PerUnitKPPll (from PLL)PLL proportional gain, example value = 20
Types.PerUnitOmegaMaxPu (from PLL)PLL Upper frequency limit in pu (base OmegaNom), example value = 1.5
Types.PerUnitOmegaMinPu (from PLL)PLL Lower frequency limit in pu (base OmegaNom), example value = 0.5
Circuit
Types.PerUnitRSourcePuResistance in pu (base SNom, UNom), example value = 0.0015
Types.PerUnitXSourcePuReactance in pu (base SNom, UNom), example value = 0.15
Initial
Types.ActivePowerPuP0PuStart value of the active power at the converter's terminal in pu (base SnRef) (receptor convention)
Types.ReactivePowerPuQ0PuStart value of the reactive power at the converter's terminal in pu (base SnRef) (receptor convention)
Types.AngleTheta0Start value of phase shift between the converter's rotating frame and the grid rotating frame in rad
Types.VoltageModulePuU0PuStart value of voltage at the converter's terminal in pu (base UNom)
Types.ComplexCurrentPui0PuStart value of complex current at converter's terminal in pu (base UNom, SnRef) (receptor convention)
Types.PerUnitIdConv0PuStart value of d-axis current of the converter in pu (base UNom, SNom) (generator convention)
Types.PerUnitIqConv0PuStart value of q-axis current of the converter in pu (base UNom, SNom) (generator convention)
Types.ComplexVoltagePuu0PuStart value of complex voltage at converter's terminal in pu (base UNom)
Types.PerUnitUdConv0PuStart value of d-axis modulation voltage in pu (base UNom)
Types.PerUnitUdFilter0PuStart value of d-axis voltage at the converter's terminal in pu (base UNom)
Types.PerUnitUqConv0PuStart value of q-axis modulation voltage in pu (base UNom)
Types.PerUnitUqFilter0PuStart value of q-axis voltage at the converter's terminal in pu (base UNom)

Connectors

TypeNameDefaultDescription
Modelica.Blocks.Interfaces.RealInputdeltaOmegaPuFrequency deviation in pu (base omegaNom)
Modelica.Blocks.Interfaces.RealInputPAuxPuAuxiliary input in pu (base SNom) (generator convention)
Modelica.Blocks.Interfaces.RealInputPRefPuActive power reference at the converter's capacitor in pu (base SNom) (generator convention)
Modelica.Blocks.Interfaces.RealInputQAuxPuAuxiliary reactive power (optional input) in pu (base SNom) (generator convention)
Modelica.Blocks.Interfaces.RealInputQRefPuReactive power reference at the converter's capacitor in pu (base SNom) (generator convention)
Modelica.Blocks.Interfaces.RealInputURefPuVoltage reference at the converter's terminal in pu (base UNom)
Dynawo.Connectors.ACPowerterminal

Components

TypeNameDefaultDescription
Dynawo.Electrical.Controls.Converters.EpriGFM.BaseControls.Comptodqcomptodq
Dynawo.Electrical.Controls.Converters.EpriGFM.BaseControls.DQTrafodQTrafo
Dynawo.Electrical.Controls.Converters.EpriGFM.BaseControls.EpriCurrentControlepriCurrentControl
Dynawo.Electrical.Controls.Converters.EpriGFM.BaseControls.EpriVoltageControlepriVoltageControl
Dynawo.Electrical.Controls.Converters.EpriGFM.BaseControls.GFMgfm
Dynawo.Electrical.Sources.InjectorURIinjectorURI
Dynawo.Electrical.Lines.Lineline
Dynawo.Electrical.Controls.WECC.Utilities.Measurementsmeasurements
Modelica.ComplexBlocks.ComplexMath.PolarToComplexpolarToComplex
Dynawo.Electrical.Controls.PLL.PLLpll
Modelica.Blocks.Sources.Constantzero
Modelica.ComplexBlocks.ComplexMath.Productproduct
Modelica.Blocks.Sources.ConstantOmegaRefPu
Modelica.Blocks.Sources.Constantconstant2
Modelica.Blocks.Logical.Switchswitch1
Modelica.Blocks.Sources.Constantone