modelBaseBESSCurrentSource

Partial base model for WECC BESS with electrical control model type C, generator/converter model type A

Extends from Dynawo.Electrical.Controls.PLL.ParamsPLL, Dynawo.Electrical.Controls.WECC.Parameters.REEC.ParamsREEC (Common REEC parameters), Dynawo.Electrical.Controls.WECC.Parameters.REEC.ParamsREECc (REEC type C parameters), Dynawo.Electrical.Controls.WECC.Parameters.REGC.ParamsREGC (Common REGC parameters), Dynawo.Electrical.Controls.WECC.Parameters.REGC.ParamsREGCa (REGC type A parameters).

Parameters

TypeNameDefaultDescription
Types.ApparentPowerModuleSNom (from ParamsREEC)Nominal apparent power in MVA
Types.CurrentModulePuId0Pu (from ParamsREEC)Start value of d-component current at injector terminal in pu (generator convention) (base SNom, UNom)
Types.CurrentModulePuIq0Pu (from ParamsREEC)Start value of q-component current at injector terminal in pu (generator convention) (base SNom, UNom)
Types.PerUnitPF0 (from ParamsREEC)Start value of power factor
Types.ActivePowerPuPConv0Pu (from ParamsREEC)Start value of active power at converter terminal in pu (generator convention) (base SNom)
Types.ReactivePowerPuQConv0Pu (from ParamsREEC)Start value of reactive power at converter terminal in pu (generator convention) (base SNom)
Types.VoltageModulePuUInj0Pu (from ParamsREEC)Start value of voltage magnitude at injector terminal in pu (base UNom)
Types.ComplexPerUnits0Pu (from ParamsREEC)Start value of complex apparent power at terminal in pu (base SnRef) (receptor convention)
Types.ComplexVoltagePuu0Pu (from ParamsREEC)Start value of complex voltage at terminal in pu (base UNom)
Types.VoltageModulePuUConv0Pu (from ParamsREEC)Start value of voltage module at converter terminal in pu (base UNom)
Types.ComplexPerUnituConv0Pu (from ParamsREEC)Start value of complex voltage at converter terminal in pu (base UNom)
Types.ComplexCurrentPui0PuStart value of complex current at terminal in pu (base UNom, SnRef) (receptor convention)
Types.ComplexPerUnitiConv0PuStart value of complex current at converter terminal in pu (base UNom, SNom) (generator convention)
Types.ActivePowerPuPInj0PuStart value of active power at injector terminal in pu (generator convention) (base SNom)
Types.ReactivePowerPuQInj0PuStart value of reactive power at injector terminal in pu (generator convention) (base SNom)
Types.PerUnitSOC0PuInitial state of charge in pu (base SNom)
Types.ComplexPerUnituInj0PuStart value of complex voltage at injector in pu (base UNom)
Types.AngleUPhaseConv0Value of voltage phase angle at converter terminal in rad
PLL
Types.PerUnitKiPLL (from ParamsPLL)PLL integrator gain
Types.PerUnitKpPLL (from ParamsPLL)PLL proportional gain
Types.AngularVelocityPuOmegaMaxPu (from ParamsPLL)Upper frequency limit in pu (base omegaNom)
Types.AngularVelocityPuOmegaMinPu (from ParamsPLL)Lower frequency limit in pu (base omegaNom)
Electrical Control › REEC
BooleanPfFlag (from ParamsREEC)Power factor flag: Q control (0) or pf control(1)
BooleanPQFlag (from ParamsREEC)Q/P priority: Q priority (0) or P priority (1)
BooleanQFlag (from ParamsREEC)Q control flag: const. pf or Q ctrl (0) or voltage/Q (1)
BooleanVFlag (from ParamsREEC)Voltage control flag: voltage control (0) or Q ctrl (1)
Types.VoltageModulePuDbd1Pu (from ParamsREEC)Overvoltage deadband for reactive current injection in pu (base UNom) (typical: -0.1..0)
Types.VoltageModulePuDbd2Pu (from ParamsREEC)Undervoltage deadband for reactive current injection in pu (base UNom) (typical: 0..0.1)
Types.PerUnitDPMaxPu (from ParamsREEC)Active power upper rate limit in pu/s (base SNom) (typical: > 0.1, set to 99 to disable)
Types.PerUnitDPMinPu (from ParamsREEC)Active power lower rate limit in pu/s (base SNom) (typical: < -0.1, set to -99 to disable)
Types.CurrentModulePuIMaxPu (from ParamsREEC)Maximal apparent current magnitude in pu (base UNom, SNom) (typical: 1..2)
Types.PerUnitIqh1Pu (from ParamsREEC)Maximum reactive current injection (typical: 1..1.1) in pu (base UNom, SNom)
Types.PerUnitIql1Pu (from ParamsREEC)Minimum reactive current injection (typical: -1.1..-1) in pu (base UNom, SNom)
Types.PerUnitKqi (from ParamsREEC)Integrator gain local reactive power PI controller
Types.PerUnitKqp (from ParamsREEC)Proportional gain local reactive power PI controller
Types.PerUnitKqv (from ParamsREEC)K-Factor, reactive current injection gain (typical: 0..10)
Types.PerUnitKvi (from ParamsREEC)Integrator gain local voltage PI controller
Types.PerUnitKvp (from ParamsREEC)Proportional gain local voltage PI controller
Types.ActivePowerPuPMaxREECPu (from ParamsREEC)Active power upper limit in REEC in pu (base SNom) (typical: 1)
Types.ActivePowerPuPMinREECPu (from ParamsREEC)Active power lower limit in REEC in pu (base SNom) (typical: 0)
Types.ReactivePowerPuQMaxREECPu (from ParamsREEC)Reactive power upper limit, when vFlag == 1 in REEC in pu (base SNom)
Types.ReactivePowerPuQMinREECPu (from ParamsREEC)Reactive power lower limit, when vFlag == 1 in REEC in pu (base SNom)
Types.TimetIq (from ParamsREEC)Filter time constant reactive current in s(typical: 0.01..0.02)
Types.TimetRv (from ParamsREEC)Filter time constant terminal voltage in s(typical: 0.01..0.02)
Types.TimetpREEC (from ParamsREEC)Active power filter time constant in REEC in s (typical: 0.1..0.2)
Types.TimetPord (from ParamsREEC)Filter time constant inverter active power in s
Types.VoltageModulePuVDipPu (from ParamsREEC)Low voltage condition trigger voltage for FRT in pu (base UNom) (typical: 0..0.9)
Types.VoltageModulePuVMaxPu (from ParamsREEC)Maximum voltage at inverter terminal in pu (base UNom) (typical: 1.05..1.15)
Types.VoltageModulePuVMinPu (from ParamsREEC)Minimum voltage at inverter terminal in pu (base UNom) (typical: 0.85..0.95)
Types.VoltageModulePuVRef0Pu (from ParamsREEC)Reference voltage for reactive current injection in pu (base UNom) (typical: 0.95..1.05)
Types.VoltageModulePuVUpPu (from ParamsREEC)High voltage condition trigger voltage for FRT in pu (base UNom) (typical: 1.1..1.3)
Electrical Control › REECc
Types.PerUnitSOCMaxPu (from ParamsREECc)Maximum allowable state of charge in pu (base SNom) (typical: 0.8..1)
Types.PerUnitSOCMinPu (from ParamsREECc)Minimum allowable state of charge in pu (base SNom) (typical: 0..0.2)
Types.TimetBattery (from ParamsREECc)Time it takes for the battery to discharge when putting out 1 pu power, in s (typically set to 9999 since most batteries are large as compared to the typical simulation time in a stability study)
Types.PerUnitVDLIp11 (from ParamsREECc)
Types.PerUnitVDLIp12 (from ParamsREECc)
Types.PerUnitVDLIp21 (from ParamsREECc)
Types.PerUnitVDLIp22 (from ParamsREECc)
Types.PerUnitVDLIp31 (from ParamsREECc)
Types.PerUnitVDLIp32 (from ParamsREECc)
Types.PerUnitVDLIp41 (from ParamsREECc)
Types.PerUnitVDLIp42 (from ParamsREECc)
Types.PerUnitVDLIq11 (from ParamsREECc)
Types.PerUnitVDLIq12 (from ParamsREECc)
Types.PerUnitVDLIq21 (from ParamsREECc)
Types.PerUnitVDLIq22 (from ParamsREECc)
Types.PerUnitVDLIq31 (from ParamsREECc)
Types.PerUnitVDLIq32 (from ParamsREECc)
Types.PerUnitVDLIq41 (from ParamsREECc)
Types.PerUnitVDLIq42 (from ParamsREECc)
Types.PerUnit[:,:]VDLIpPoints (from ParamsREECc)[VDLIp11, VDLIp12; VDLIp21, VDLIp22; VDLIp31, VDLIp32; VDLIp41, VDLIp42]Pair of points for voltage-dependent active current limitation piecewise linear curve [u1,y1; u2,y2;...]
Types.PerUnit[:,:]VDLIqPoints (from ParamsREECc)[VDLIq11, VDLIq12; VDLIq21, VDLIq22; VDLIq31, VDLIq32; VDLIq41, VDLIq42]Pair of points for voltage-dependent reactive current limitation piecewise linear curve [u1,y1; u2,y2;...]
Generator Converter › REGC
Types.PerUnitIqrMaxPu (from ParamsREGC)Maximum rate-of-change of reactive current after fault in pu (base UNom, SNom) (typical: 1..999)
Types.PerUnitIqrMinPu (from ParamsREGC)Minimum rate-of-change of reactive current after fault in pu (base UNom, SNom) (typical: -999..-1)
Types.PerUnitRrpwrPu (from ParamsREGC)Active current (or power if RateFlag = true) recovery rate in pu/s (base UNom, SNom) (typical: 1..20)
Types.TimetFilterGC (from ParamsREGC)Filter time constant of terminal voltage in s(Cannot be set to zero, typical: 0.02..0.05)
Generator Converter › REGCa
Types.TimetG (from ParamsREGCa)Emulated delay in converter controls in s(Cannot be zero, typical: 0.02..0.05)
Types.PerUnitbrkpt (from ParamsREGCa)LVPL breakpoint in pu (base UNom)
Types.PerUnitlvpl1 (from ParamsREGCa)LVPL gain breakpoint in pu
BooleanLvplsw (from ParamsREGCa)Low voltage power logic switch: 1-enabled/0-disabled
Types.PerUnitzerox (from ParamsREGCa)LVPL zero crossing in pu (base UNom)

Connectors

TypeNameDefaultDescription
Modelica.Blocks.Interfaces.RealInputomegaRefPu
Modelica.Blocks.Interfaces.RealInputPAuxPuAuxiliary input in pu (base SNom) (generator convention)
Modelica.Blocks.Interfaces.RealInputPFaRefPower factor angle reference in rad

Components

TypeNameDefaultDescription
Dynawo.Electrical.Controls.WECC.REEC.REECcreecC
Dynawo.Electrical.Controls.WECC.REGC.REGCaregcA
Controls.PLL.PLLpll
Sources.InjectorIDQinjector
Dynawo.Electrical.Controls.WECC.Utilities.MeasurementsLvMeasurements
Sources.IEC.BaseConverters.ElecSystemLvTfo