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
| Type | Name | Default | Description |
|---|---|---|---|
| CurrentControl | |||
| Types.PerUnit | KPi (from CurrentControl) | Proportional gain of the current loop, example value = 0.5 | |
| Types.PerUnit | KIi (from CurrentControl) | Integral gain of the current loop, example value = 5 | |
| Types.Time | tE (from CurrentControl) | PT1 constant for voltage output in s, example value = 0.01 | |
| VoltageControl | |||
| Types.PerUnit | IMaxPu (from VoltageControl) | Max current in pu (base UNom, SNom), example value = 1.05 | |
| Types.PerUnit | KIp (from VoltageControl) | Integral gain of the power loop, example value = 10 | |
| Types.PerUnit | KIv (from VoltageControl) | Integral gain of the voltage loop, example value = 150 if OmegaFlag=0 else 10 | |
| Types.PerUnit | KPp (from VoltageControl) | Proportional gain of the power loop, example value = 2 | |
| Types.PerUnit | KPv (from VoltageControl) | Proportional gain of the voltage loop, example value = 0.5 if OmegaFlag=0 else 2.0 | |
| Types.PerUnit | OmegaDroopPu (from VoltageControl) | Frequency droop in pu, example value = 0.05 | |
| Boolean | PQFlag (from VoltageControl) | Active or active power priority flag: false = P priority, true = Q priority | |
| Types.PerUnit | QDroopPu (from VoltageControl) | Voltage droop in pu, example value = 0.2 | |
| Types.PerUnit | UDipPu (from VoltageControl) | Freeze voltage in pu (base UNom), example value = 0.85 | |
| GFM | |||
| Types.PerUnit | DD (from Gfm) | VSM damping factor, example value = 0.11 | |
| Types.PerUnit | DeltaOmegaMaxPu (from Gfm) | Frequency deviation maximum in pu/s (base omegaNom), example value = 75(rad/s)/omegaNom | |
| Types.PerUnit | DeltaOmegaMinPu (from Gfm) | Frequency deviation minimum in pu/s (base omegaNom), example value = -75(rad/s)/omegaNom | |
| Types.PerUnit | K1 (from Gfm) | Gain, set according to OmegaFlag | |
| Types.PerUnit | K2 (from Gfm) | Gain, set according to OmegaFlag | |
| Types.PerUnit | K2Dvoc (from Gfm) | Gain, set according to OmegaFlag | |
| Types.PerUnit | KD (from Gfm) | Gain of the active damping, Set according to OmegaFlag | |
| Types.PerUnit | MF (from Gfm) | VSM inertia constant, example value = 0.15 | |
| Types.Time | tF (from Gfm) | Time constant in s, set according to OmegaFlag | |
| Types.Time | tR (from Gfm) | Transducer time constant in s, example value = 0.005 | |
| Types.Time | tV (from Gfm) | Time constant in s, set according to OmegaFlag | |
| General | |||
| Integer | OmegaFlag (from OmegaFlag) | GFM control type; 0=GFL, 1=droop, 2=VSM, 3=dVOC | |
| Types.ApparentPowerModule | SNom | Nominal apparent power in MVA | |
| Pll | |||
| Types.PerUnit | KIPll (from PLL) | PLL integrator gain, example value = 700 | |
| Types.PerUnit | KPPll (from PLL) | PLL proportional gain, example value = 20 | |
| Types.PerUnit | OmegaMaxPu (from PLL) | PLL Upper frequency limit in pu (base OmegaNom), example value = 1.5 | |
| Types.PerUnit | OmegaMinPu (from PLL) | PLL Lower frequency limit in pu (base OmegaNom), example value = 0.5 | |
| Circuit | |||
| Types.PerUnit | RSourcePu | Resistance in pu (base SNom, UNom), example value = 0.0015 | |
| Types.PerUnit | XSourcePu | Reactance in pu (base SNom, UNom), example value = 0.15 | |
| Initial | |||
| Types.ActivePowerPu | P0Pu | Start value of the active power at the converter's terminal in pu (base SnRef) (receptor convention) | |
| Types.ReactivePowerPu | Q0Pu | Start value of the reactive power at the converter's terminal in pu (base SnRef) (receptor convention) | |
| Types.Angle | Theta0 | Start value of phase shift between the converter's rotating frame and the grid rotating frame in rad | |
| Types.VoltageModulePu | U0Pu | Start value of voltage at the converter's terminal in pu (base UNom) | |
| Types.ComplexCurrentPu | i0Pu | Start value of complex current at converter's terminal in pu (base UNom, SnRef) (receptor convention) | |
| Types.PerUnit | IdConv0Pu | Start value of d-axis current of the converter in pu (base UNom, SNom) (generator convention) | |
| Types.PerUnit | IqConv0Pu | Start value of q-axis current of the converter in pu (base UNom, SNom) (generator convention) | |
| Types.ComplexVoltagePu | u0Pu | Start value of complex voltage at converter's terminal in pu (base UNom) | |
| Types.PerUnit | UdConv0Pu | Start value of d-axis modulation voltage in pu (base UNom) | |
| Types.PerUnit | UdFilter0Pu | Start value of d-axis voltage at the converter's terminal in pu (base UNom) | |
| Types.PerUnit | UqConv0Pu | Start value of q-axis modulation voltage in pu (base UNom) | |
| Types.PerUnit | UqFilter0Pu | Start value of q-axis voltage at the converter's terminal in pu (base UNom) | |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Blocks.Interfaces.RealInput | deltaOmegaPu | Frequency deviation in pu (base omegaNom) | |
| Modelica.Blocks.Interfaces.RealInput | PAuxPu | Auxiliary input in pu (base SNom) (generator convention) | |
| Modelica.Blocks.Interfaces.RealInput | PRefPu | Active power reference at the converter's capacitor in pu (base SNom) (generator convention) | |
| Modelica.Blocks.Interfaces.RealInput | QAuxPu | Auxiliary reactive power (optional input) in pu (base SNom) (generator convention) | |
| Modelica.Blocks.Interfaces.RealInput | QRefPu | Reactive power reference at the converter's capacitor in pu (base SNom) (generator convention) | |
| Modelica.Blocks.Interfaces.RealInput | URefPu | Voltage reference at the converter's terminal in pu (base UNom) | |
| Dynawo.Connectors.ACPower | terminal |