modelDERa
Aggregated model of inverter-based generation (IBG) as defined by EPRI under the name der_a
Extends from BaseClasses.BaseDERa (Base model for der_a (Distributed Energy Resources model)).
Information
Aggregated model of inverter-based generation (IBG) as defined in https://www.epri.com/research/products/000000003002015320.Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Types.ApparentPowerModule | SNom (from BaseDERa) | Nominal apparent power of the injector (in MVA) | |
| Types.CurrentModulePu | IMaxPu (from BaseDERa) | Maximum current of the injector in pu (base UNom, SNom) | |
| Boolean | PPriority (from BaseDERa) | If true, prioritise active power over reactive power | |
| Real | KpPll (from BaseDERa) | 3 | PLL proportional coefficient |
| Real | KiPll (from BaseDERa) | 10 | PLL integral coefficient |
| Types.Time | tFilterU (from BaseDERa) | Voltage measurement first order time constant in s | |
| Types.Time | tFilterOmega (from BaseDERa) | First order time constant for the frequency estimation in s | |
| Types.Time | tRateLim (from BaseDERa) | 1e-3 | Current slew limiter delay in s |
| Types.Time | tP (from BaseDERa) | P measurement first order time constant in s | |
| Types.Time | tG (from BaseDERa) | Output current time constant in s | |
| Types.Time | tPord (from BaseDERa) | Active power time constant in s | |
| Types.Time | tIq (from BaseDERa) | Reactive current time constant in s | |
| Types.AngularVelocityPu | FDbd1Pu (from BaseDERa) | Lower value of frequency dead zone in pu (base omegaNom) | |
| Types.AngularVelocityPu | FDbd2Pu (from BaseDERa) | Upper value of frequency dead zone in pu (base omegaNom) | |
| Real | DdnPu (from BaseDERa) | Power reduction factor for over-frequency in pu (base SNom) | |
| Real | DupPu (from BaseDERa) | Power increase factor for under-frequency in pu (base SNom) | |
| Types.AngularVelocityPu | FEMaxPu (from BaseDERa) | Maximum frequency error correction in pu (base omegaNom) | |
| Types.AngularVelocityPu | FEMinPu (from BaseDERa) | Minimum frequency error correction in pu (base omegaNom) | |
| Real | Kpg (from BaseDERa) | PI proportional coefficient of frequency support in pu (base SNom, omegaNom) | |
| Real | Kig (from BaseDERa) | PI integral coefficient of frequency support in pu (base SNom, omegaNom) | |
| Types.ActivePowerPu | PMaxPu (from BaseDERa) | Maximum active power in pu (base SNom) | |
| Types.ActivePowerPu | PMinPu (from BaseDERa) | Minimum active power in pu (base SNom) | |
| Types.PerUnit | DPMaxPu (from BaseDERa) | Maximum active power rise rate in pu (base SNom) | |
| Types.PerUnit | DPMinPu (from BaseDERa) | Minimum active power drop rate in pu (base SNom) | |
| Boolean | FreqFlag (from BaseDERa) | True if inverters support frequency | |
| Types.AngularVelocityPu | OmegaMaxPu (from BaseDERa) | Maximum frequency before disconnection in pu (base omegaNom) | |
| Types.AngularVelocityPu | OmegaMinPu (from BaseDERa) | Minimum frequency before start of disconnections in pu (base omegaNom) | |
| Types.Time | tOmegaMaxPu (from BaseDERa) | Time-lag for over-frequency trips in s | |
| Types.Time | tOmegaMinPu (from BaseDERa) | Time-lag for under-frequency trips in s | |
| Types.CurrentModulePu | IpRateLimMax (from BaseDERa) | Maximum rise rate of the active current in pu (base SNom) | |
| Types.CurrentModulePu | IpRateLimMin (from BaseDERa) | Minimum drop rate of the active current in pu (base SNom) | |
| Boolean | PfFlag (from BaseDERa) | True for constant power factor, false for constant reactive power | |
| Types.VoltageModulePu | VRefPu (from BaseDERa) | 1 | Voltage reference in pu (base UNom) |
| Types.VoltageModulePu | Dbd1Pu (from BaseDERa) | Lower value of voltage dead zone in pu (base UNom) | |
| Types.VoltageModulePu | Dbd2Pu (from BaseDERa) | Upper value of voltage dead zone in pu (base UNom) | |
| Real | Kqv (from BaseDERa) | Proportional coefficient of reactive support in pu (base SNom, UNom) | |
| Types.CurrentModulePu | Iqh1 (from BaseDERa) | Maximum reactive support current command (base SNom, UNom) | |
| Types.CurrentModulePu | Iql1 (from BaseDERa) | Maximum reactive support current command (base SNom, UNom) | |
| Types.ComplexCurrentPu | i0Pu (from BaseDERa) | Start value of complex current at terminal in pu (base UNom, SnRef) (receptor convention) | |
| Types.PerUnit | Id0Pu (from BaseDERa) | Start value of d-axs current at injector in pu (base UNom, SNom) (generator convention) | |
| Types.PerUnit | Iq0Pu (from BaseDERa) | Start value of q-axis current at injector in pu (base UNom, SNom) (generator convention) | |
| Types.ActivePowerPu | P0Pu (from BaseDERa) | Start value of active power at terminal in pu (base SnRef) (receptor convention) | |
| Types.PerUnit | PF0 (from BaseDERa) | Start value of power factor | |
| Types.ReactivePowerPu | Q0Pu (from BaseDERa) | Start value of reactive power at terminal in pu (base SnRef) (receptor convention) | |
| Types.ComplexApparentPowerPu | s0Pu (from BaseDERa) | Start value of complex apparent power at terminal in pu (base SnRef) (receptor convention) | |
| Types.VoltageModulePu | U0Pu (from BaseDERa) | Start value of voltage magnitude at terminal in pu (base UNom) | |
| Types.ComplexVoltagePu | u0Pu (from BaseDERa) | Start value of complex voltage at terminal in pu (base UNom) | |
| Types.Angle | UPhase0 (from BaseDERa) | Start value of voltage phase angle at terminal in rad | |
| Types.VoltageModulePu | Ul0Pu | Voltage threshold under which all inverters are disconnected in pu (base UNom) | |
| Types.VoltageModulePu | Ul1Pu | Voltage threshold under which inverters start to disconnect in pu (base UNom) | |
| Types.Time | tvl0 | Time after which inverters stay definitively disconnected if V < Ul0Pu in s | |
| Types.Time | tvl1 | Time after which non-recovering inverters stay disconnected if V < Ul1Pu in s | |
| Types.VoltageModulePu | Uh0Pu | Voltage threshold over which all inverters are disconnected in pu (base UNom) | |
| Types.VoltageModulePu | Uh1Pu | Voltage threshold over which inverters start to disconnect in pu (base UNom) | |
| Types.Time | tvh0 | Time after which inverters stay definitively disconnected if V > Uh0Pu in s | |
| Types.Time | tvh1 | Time after which non-recovering inverters stay disconnected if V > Uh1Pu in s | |
| Real | RecoveringShare | Share of inverters that reconnect after mild voltage deviations |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Blocks.Interfaces.RealInput | omegaRefPu (from BaseDERa) | Reference angular frequency in pu (base omegaNom) | |
| Modelica.Blocks.Interfaces.RealInput | PFaRef (from BaseDERa) | Power factor angle reference in rad | |
| Modelica.Blocks.Interfaces.RealInput | PRefPu (from BaseDERa) | Available power from the DC source in pu (base SNom) | |
| Modelica.Blocks.Interfaces.RealInput | QRefPu (from BaseDERa) | Reactive power setpoint in pu (base SNom) | |
| Dynawo.Connectors.ACPower | terminal (from BaseDERa) |