modelBaseIBG

Generic model of inverter-based generation (IBG)

Information

Generic model of inverter-based generation as defined in p28 of Gilles Chaspierre's PhD thesis 'Reduced-order modelling of active distribution networks for large-disturbance simulations'. Available: https://orbi.uliege.be/handle/2268/251602

Parameters

TypeNameDefaultDescription
Types.CurrentModulePuIMaxPuMaximum current of the injector in pu (base UNom, SNom)
Types.ApparentPowerModuleSNomNominal apparent power of the injector (in MVA)
Types.PerUnitKiPLL integrator gain
Types.PerUnitKpPLL proportional gain
Types.TimetFilterOmegaFirst order time constant for the frequency estimation in s
Types.TimetFilterUVoltage measurement first order time constant in s
Types.TimetGCurrent commands filter in s
Types.TimetRateLim1e-2Current slew limiter delay in s
Types.AngularVelocityPuOmegaDeadBandPuDeadband of the overfrequency contribution in pu (base omegaNom)
Types.AngularVelocityPuOmegaMaxPuMaximum frequency before disconnection in pu (base omegaNom)
Types.AngularVelocityPuOmegaMinPuMinimum frequency before start of disconnections in pu (base omegaNom)
RealkRCASlope of reactive current decrease for high voltages in pu (base UNom, SNom)
RealkRCISlope of reactive current increase for low voltages in pu (base UNom, SNom)
RealmCurrent injection just outside of lower deadband in pu (base IMaxPu)
RealnCurrent injection just outside of upper deadband in pu (base IMaxPu)
Types.VoltageModulePuUMaxPuMaximum voltage over which the unit is disconnected in pu (base UNom)
Types.VoltageModulePuUS1Lower voltage limit of deadband in pu (base UNom)
Types.VoltageModulePuUS2Higher voltage limit of deadband in pu (base UNom)
Types.TimetLVRTMaxTime delay of trip for small voltage dips in s
Types.TimetLVRTMinTime delay of trip for severe voltage dips in s
Types.TimetLVRTIntTime delay of trip for intermediate voltage dips in s
Types.VoltageModulePuULVRTArmingPuVoltage threshold under which the automaton is activated after tLVRTMax in pu (base UNom)
Types.VoltageModulePuULVRTIntPuVoltage threshold under which the automaton is activated after tLVRTMin in pu (base UNom)
Types.VoltageModulePuULVRTMinPuVoltage threshold under which the automaton is activated instantaneously in pu (base UNom)
RealIpSlewMaxPuActive current slew limit (both up and down) in pu (base UNom, SNom)
RealIqSlewMaxPuReactive current slew limit (both up and down) in pu (base UNom, SNom) (not in the original model, can use arbitrarily large value to bypass it)
Types.VoltageModulePuUPLLFreezePuPLL freeze voltage threshold in pu (base UNom)
Types.VoltageModulePuUQPrioPuVoltage under which priority is given to reactive current injection in pu (base UNom)
Types.ComplexCurrentPui0PuStart value of complex current at terminal in pu (base UNom, SnRef) (receptor convention)
Types.PerUnitId0PuStart value of d-axs current at injector in pu (base UNom, SNom) (generator convention)
Types.PerUnitIq0PuStart value of q-axis current at injector in pu (base UNom, SNom) (generator convention)
Types.PerUnitIqRef0PuStart value of the reference q-axis current at injector in pu (base UNom, SNom) (generator convention)
Types.ActivePowerPuP0PuStart value of active power at terminal in pu (base SnRef) (receptor convention)
Types.ReactivePowerPuQ0PuStart value of reactive power at terminal in pu (base SnRef) (receptor convention)
Types.ComplexApparentPowerPus0PuStart value of complex apparent power at terminal in pu (base SnRef) (receptor convention)
Types.VoltageModulePuU0PuStart value of voltage magnitude at terminal in pu (base UNom)
Types.ComplexVoltagePuu0PuStart value of complex voltage at terminal in pu (base UNom)
Types.AngleUPhase0Start value of voltage phase angle at terminal in rad

Connectors

TypeNameDefaultDescription
Modelica.Blocks.Interfaces.RealInputPextPuAvailable power from the DC source in pu (base SNom)
Modelica.Blocks.Interfaces.RealInputiQrefPuTarget reactive current in pu (base UNom, SNom)
Modelica.Blocks.Interfaces.RealInputomegaRefPuReference angular frequency in pu (base omegaNom)
Dynawo.Connectors.ACPowerterminal

Components

TypeNameDefaultDescription
Dynawo.Electrical.Sources.InjectorIDQinjector
Dynawo.Electrical.Controls.PLL.PLLFreezePLLFreeze
Modelica.Blocks.Continuous.FirstOrderUFilter
Modelica.Blocks.Logical.LessThresholdVfreeze
Modelica.Blocks.Math.Divisiondivision
Modelica.Blocks.Nonlinear.VariableLimiteriPLimiter
Modelica.Blocks.Sources.Constantconst
Modelica.Blocks.Math.MaxuLowerBound
Modelica.Blocks.Sources.Constantconstant1
Modelica.Blocks.Logical.GreaterThresholdcurrentPriority
Dynawo.Electrical.Controls.PEIR.BaseControls.DER.LimitUpdatinglimitUpdating
Dynawo.Electrical.Controls.PEIR.BaseControls.DER.VoltageSupportIBGvoltageSupport
Modelica.Blocks.Math.Addadd
Modelica.Blocks.Nonlinear.VariableLimiteriQLimiter
Modelica.Blocks.Continuous.FirstOrderiQcmdFirstOrder
Modelica.Blocks.Continuous.FirstOrderomegaFilter
Modelica.Blocks.Math.Addadd2
Controls.Machines.Protections.OVAoverVoltageProtection
Dynawo.NonElectrical.Blocks.NonLinear.StandAloneRampRateLimiteriPSlewLimit
Dynawo.NonElectrical.Blocks.NonLinear.StandAloneRampRateLimiteriQSlewLimit
Modelica.Blocks.Continuous.FirstOrderiPcmdFirstOrder
Modelica.Blocks.Math.Gaingain
Modelica.Blocks.Continuous.FirstOrderiQLimitFilter
Modelica.Blocks.Continuous.FirstOrderiDLimitFilter