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

TypeNameDefaultDescription
Types.ApparentPowerModuleSNom (from BaseDERa)Nominal apparent power of the injector (in MVA)
Types.CurrentModulePuIMaxPu (from BaseDERa)Maximum current of the injector in pu (base UNom, SNom)
BooleanPPriority (from BaseDERa)If true, prioritise active power over reactive power
RealKpPll (from BaseDERa)3PLL proportional coefficient
RealKiPll (from BaseDERa)10PLL integral coefficient
Types.TimetFilterU (from BaseDERa)Voltage measurement first order time constant in s
Types.TimetFilterOmega (from BaseDERa)First order time constant for the frequency estimation in s
Types.TimetRateLim (from BaseDERa)1e-3Current slew limiter delay in s
Types.TimetP (from BaseDERa)P measurement first order time constant in s
Types.TimetG (from BaseDERa)Output current time constant in s
Types.TimetPord (from BaseDERa)Active power time constant in s
Types.TimetIq (from BaseDERa)Reactive current time constant in s
Types.AngularVelocityPuFDbd1Pu (from BaseDERa)Lower value of frequency dead zone in pu (base omegaNom)
Types.AngularVelocityPuFDbd2Pu (from BaseDERa)Upper value of frequency dead zone in pu (base omegaNom)
RealDdnPu (from BaseDERa)Power reduction factor for over-frequency in pu (base SNom)
RealDupPu (from BaseDERa)Power increase factor for under-frequency in pu (base SNom)
Types.AngularVelocityPuFEMaxPu (from BaseDERa)Maximum frequency error correction in pu (base omegaNom)
Types.AngularVelocityPuFEMinPu (from BaseDERa)Minimum frequency error correction in pu (base omegaNom)
RealKpg (from BaseDERa)PI proportional coefficient of frequency support in pu (base SNom, omegaNom)
RealKig (from BaseDERa)PI integral coefficient of frequency support in pu (base SNom, omegaNom)
Types.ActivePowerPuPMaxPu (from BaseDERa)Maximum active power in pu (base SNom)
Types.ActivePowerPuPMinPu (from BaseDERa)Minimum active power in pu (base SNom)
Types.PerUnitDPMaxPu (from BaseDERa)Maximum active power rise rate in pu (base SNom)
Types.PerUnitDPMinPu (from BaseDERa)Minimum active power drop rate in pu (base SNom)
BooleanFreqFlag (from BaseDERa)True if inverters support frequency
Types.AngularVelocityPuOmegaMaxPu (from BaseDERa)Maximum frequency before disconnection in pu (base omegaNom)
Types.AngularVelocityPuOmegaMinPu (from BaseDERa)Minimum frequency before start of disconnections in pu (base omegaNom)
Types.TimetOmegaMaxPu (from BaseDERa)Time-lag for over-frequency trips in s
Types.TimetOmegaMinPu (from BaseDERa)Time-lag for under-frequency trips in s
Types.CurrentModulePuIpRateLimMax (from BaseDERa)Maximum rise rate of the active current in pu (base SNom)
Types.CurrentModulePuIpRateLimMin (from BaseDERa)Minimum drop rate of the active current in pu (base SNom)
BooleanPfFlag (from BaseDERa)True for constant power factor, false for constant reactive power
Types.VoltageModulePuVRefPu (from BaseDERa)1Voltage reference in pu (base UNom)
Types.VoltageModulePuDbd1Pu (from BaseDERa)Lower value of voltage dead zone in pu (base UNom)
Types.VoltageModulePuDbd2Pu (from BaseDERa)Upper value of voltage dead zone in pu (base UNom)
RealKqv (from BaseDERa)Proportional coefficient of reactive support in pu (base SNom, UNom)
Types.CurrentModulePuIqh1 (from BaseDERa)Maximum reactive support current command (base SNom, UNom)
Types.CurrentModulePuIql1 (from BaseDERa)Maximum reactive support current command (base SNom, UNom)
Types.ComplexCurrentPui0Pu (from BaseDERa)Start value of complex current at terminal in pu (base UNom, SnRef) (receptor convention)
Types.PerUnitId0Pu (from BaseDERa)Start value of d-axs current at injector in pu (base UNom, SNom) (generator convention)
Types.PerUnitIq0Pu (from BaseDERa)Start value of q-axis current at injector in pu (base UNom, SNom) (generator convention)
Types.ActivePowerPuP0Pu (from BaseDERa)Start value of active power at terminal in pu (base SnRef) (receptor convention)
Types.PerUnitPF0 (from BaseDERa)Start value of power factor
Types.ReactivePowerPuQ0Pu (from BaseDERa)Start value of reactive power at terminal in pu (base SnRef) (receptor convention)
Types.ComplexApparentPowerPus0Pu (from BaseDERa)Start value of complex apparent power at terminal in pu (base SnRef) (receptor convention)
Types.VoltageModulePuU0Pu (from BaseDERa)Start value of voltage magnitude at terminal in pu (base UNom)
Types.ComplexVoltagePuu0Pu (from BaseDERa)Start value of complex voltage at terminal in pu (base UNom)
Types.AngleUPhase0 (from BaseDERa)Start value of voltage phase angle at terminal in rad
Types.VoltageModulePuUl0PuVoltage threshold under which all inverters are disconnected in pu (base UNom)
Types.VoltageModulePuUl1PuVoltage threshold under which inverters start to disconnect in pu (base UNom)
Types.Timetvl0Time after which inverters stay definitively disconnected if V < Ul0Pu in s
Types.Timetvl1Time after which non-recovering inverters stay disconnected if V < Ul1Pu in s
Types.VoltageModulePuUh0PuVoltage threshold over which all inverters are disconnected in pu (base UNom)
Types.VoltageModulePuUh1PuVoltage threshold over which inverters start to disconnect in pu (base UNom)
Types.Timetvh0Time after which inverters stay definitively disconnected if V > Uh0Pu in s
Types.Timetvh1Time after which non-recovering inverters stay disconnected if V > Uh1Pu in s
RealRecoveringShareShare of inverters that reconnect after mild voltage deviations

Connectors

TypeNameDefaultDescription
Modelica.Blocks.Interfaces.RealInputomegaRefPu (from BaseDERa)Reference angular frequency in pu (base omegaNom)
Modelica.Blocks.Interfaces.RealInputPFaRef (from BaseDERa)Power factor angle reference in rad
Modelica.Blocks.Interfaces.RealInputPRefPu (from BaseDERa)Available power from the DC source in pu (base SNom)
Modelica.Blocks.Interfaces.RealInputQRefPu (from BaseDERa)Reactive power setpoint in pu (base SNom)
Dynawo.Connectors.ACPowerterminal (from BaseDERa)

Components

TypeNameDefaultDescription
Types.PerUnitpartialTrippingRatio (from BaseDERa)Coefficient for partial tripping of generators, equals 1 if no trips, 0 if all units are tripped
Dynawo.Electrical.Sources.InjectorIDQinjector (from BaseDERa)
Modelica.Blocks.Continuous.FirstOrderUFilter (from BaseDERa)
Modelica.Blocks.Math.Divisiondivision (from BaseDERa)
Modelica.Blocks.Math.Maxmax1 (from BaseDERa)
Modelica.Blocks.Sources.Constantconstant1 (from BaseDERa)
Modelica.Blocks.Math.Addadd (from BaseDERa)
Modelica.Blocks.Continuous.FirstOrderiQcmdFirstOrder (from BaseDERa)
Modelica.Blocks.Continuous.FirstOrderomegaFilter (from BaseDERa)
Modelica.Blocks.Math.Gaingain (from BaseDERa)
Modelica.Blocks.Math.ProductIpPartialTripping (from BaseDERa)
Modelica.Blocks.Math.ProductIqPartialTripping (from BaseDERa)
Modelica.Blocks.Sources.RealExpressionPartialTripping1 (from BaseDERa)
Modelica.Blocks.Sources.RealExpressionPartialTripping2 (from BaseDERa)
Modelica.Blocks.Nonlinear.VariableLimitervariableLimiter (from BaseDERa)
Modelica.Blocks.Nonlinear.VariableLimitervariableLimiter1 (from BaseDERa)
Modelica.Blocks.Continuous.FirstOrderfirstOrder2 (from BaseDERa)
Dynawo.Electrical.Controls.WECC.BaseControls.CurrentLimitsCalculationBcurrentLimitsCalculation1 (from BaseDERa)
Modelica.Blocks.Continuous.FirstOrderfirstOrder3 (from BaseDERa)
Dynawo.Electrical.Controls.PLL.PLLpll (from BaseDERa)
Modelica.Blocks.Sources.Constantconstant2 (from BaseDERa)
Modelica.Blocks.Math.Feedbackfeedback (from BaseDERa)
Modelica.Blocks.Nonlinear.LimiterfrequencyErrorLimit (from BaseDERa)
Dynawo.NonElectrical.Blocks.Continuous.PIAntiWinduppowerPIAntiWinDupPu (from BaseDERa)
Modelica.Blocks.Logical.Switchswitch (from BaseDERa)
Modelica.Blocks.Nonlinear.SlewRateLimiterpowerRateLimit (from BaseDERa)
Modelica.Blocks.Sources.BooleanConstantfrequencyFlag (from BaseDERa)
Modelica.Blocks.Math.Divisiondivision1 (from BaseDERa)
Modelica.Blocks.Nonlinear.DeadZonefrequencyDeadZone (from BaseDERa)
Modelica.Blocks.Math.Add3add3 (from BaseDERa)
Modelica.Blocks.Continuous.FirstOrderfirstOrder (from BaseDERa)
Modelica.Blocks.Sources.ConstantVref (from BaseDERa)
Modelica.Blocks.Math.Feedbackfeedback1 (from BaseDERa)
Modelica.Blocks.Nonlinear.DeadZonevoltageDeadZone (from BaseDERa)
Modelica.Blocks.Math.Gaingain1 (from BaseDERa)
Modelica.Blocks.Logical.Switchswitch1 (from BaseDERa)
Modelica.Blocks.Continuous.FirstOrderIqCmdFilter (from BaseDERa)
Dynawo.NonElectrical.Blocks.Continuous.RateLimFirstOrderFreezeIpRateLimiter (from BaseDERa)
Modelica.Blocks.Sources.ConstantIpRateMax (from BaseDERa)
Modelica.Blocks.Sources.ConstantIpRateMin (from BaseDERa)
Modelica.Blocks.Math.Gaingain2 (from BaseDERa)
Modelica.Blocks.Math.Gaingain3 (from BaseDERa)
Modelica.Blocks.Nonlinear.Limiterdown (from BaseDERa)
Modelica.Blocks.Nonlinear.Limiterup (from BaseDERa)
Modelica.Blocks.Math.Addadd1 (from BaseDERa)
Modelica.Blocks.Continuous.FirstOrderpOrderFilter (from BaseDERa)
Modelica.Blocks.Nonlinear.LimiterreactiveSupportLimit (from BaseDERa)
Modelica.Blocks.Nonlinear.LimiterpOrdLimit (from BaseDERa)
Dynawo.Electrical.Controls.PEIR.Protections.DER.FRTDERaFRT (from BaseDERa)
Modelica.Blocks.Sources.BooleanConstantPFFlag (from BaseDERa)
Modelica.Blocks.Math.Productproduct (from BaseDERa)
Modelica.Blocks.Math.Tantan (from BaseDERa)
Dynawo.Electrical.Controls.PEIR.Protections.DER.LVRTDERalvrt
Dynawo.Electrical.Controls.PEIR.Protections.DER.OVRTDERaovrt