modelBESSCurrentSource

WECC BESS with electrical control model type C, generator/converter model type A and plant control type A

Extends from Dynawo.Electrical.BESS.WECC.BaseClasses.BaseBESSCurrentSource (Partial base model for WECC BESS with electrical control model type C, generator/converter model type A), Dynawo.Electrical.Controls.WECC.Parameters.REPC.ParamsREPC, Dynawo.Electrical.Wind.WECC.BaseClasses.BasePCS (Base model of the Power Collection System to be extended in the WECC models of power plants).

Information


The power collection system and measurement nodes are not specified in the WECC standard. Thus, we decided to make it flexible in the model. 

With ConverterLVControl switch, you decide whether the inverter is controlling P,Q,U in low voltage or medium voltage. 

With PPCLocal switch, you decide whether the plant controller is controlling P, Q, U at the model terminal or at a node outside the model.

Depending on PPCLocal and ConverterLVControl's values, the impedances of the group transformer (RLvTrPu, XLvTrPu) and of the main transformer (BMvHvPu ,GMvHvPu, RMvHvPu, XMvHvPu) won't be applied to the same block model. The following diagram explains it :
 

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.ComplexCurrentPui0Pu (from BaseBESSCurrentSource)Start value of complex current at terminal in pu (base UNom, SnRef) (receptor convention)
Types.ComplexPerUnitiConv0Pu (from BaseBESSCurrentSource)Start value of complex current at converter terminal in pu (base UNom, SNom) (generator convention)
Types.ActivePowerPuPInj0Pu (from BaseBESSCurrentSource)Start value of active power at injector terminal in pu (generator convention) (base SNom)
Types.ReactivePowerPuQInj0Pu (from BaseBESSCurrentSource)Start value of reactive power at injector terminal in pu (generator convention) (base SNom)
Types.PerUnitSOC0Pu (from BaseBESSCurrentSource)Initial state of charge in pu (base SNom)
Types.ComplexPerUnituInj0Pu (from BaseBESSCurrentSource)Start value of complex voltage at injector in pu (base UNom)
Types.AngleUPhaseConv0 (from BaseBESSCurrentSource)Value of voltage phase angle at converter terminal in rad
Types.PerUnitRPu (from ParamsLvTfo)if ConverterLVControl then 1e-5 else RLvTrPuSerial resistance between injector output and LvTfo in pu (base UNom, SNom). Including source resistance for voltage source.
Types.PerUnitXPu (from ParamsLvTfo)if ConverterLVControl then 1e-5 else XLvTrPuSerial reactance between injector output and LvTfo in pu (base UNom, SNom). Including source resistance for voltage source.
Types.PerUnitBPcsPu (from ParamsPCS)if PPCLocal then BMvHvPu else 1e-5Shunt susceptance between converter terminal and model's output terminal in pu (base UNom, SNom)
Types.PerUnitGPcsPu (from ParamsPCS)if PPCLocal then GMvHvPu else 1e-5Shunt conductance between converter terminal and model's output terminal in pu (base UNom, SNom)
Types.PerUnitRPcsPu (from ParamsPCS)if PPCLocal and ConverterLVControl then RLvTrPu + RMvHvPu elseif PPCLocal and not ConverterLVControl then RMvHvPu elseif not PPCLocal and ConverterLVControl then RLvTrPu else 1e-5Serial resistance between converter terminal and model's output terminal in pu (base UNom, SNom)
Types.PerUnitXPcsPu (from ParamsPCS)if PPCLocal and ConverterLVControl then XLvTrPu + XMvHvPu elseif PPCLocal and not ConverterLVControl then XMvHvPu elseif not PPCLocal and ConverterLVControl then XLvTrPu else 1e-5Serial reactance between converter terminal and model's output terminal in pu (base UNom, SNom)
Types.ComplexCurrentPuiControl0Pu (from BasePCS)if PPCLocal then i0Pu else iPcc0PuInitial complex current to be controlled by the PPC coming either from the external bus or from the model's output terminal in pu (base UNom, SnRef) (receptor convention)
Types.ComplexCurrentPuiPcc0Pu (from BasePCS)ComplexMath.conj(Complex(PPcc0Pu, QPcc0Pu)/uPcc0Pu)Start value of complex current at external PCC in pu (used when PPCLocal = false, meaning the PCS is defined outside of the model) in pu (base UNom, SnRef) (receptor convention)
Types.ActivePowerPuP0Pu (from BasePCS)Start value of active power at converter terminal in pu (base SnRef) (receptor convention)
Types.ActivePowerPuPControl0Pu (from BasePCS)if PPCLocal then -P0Pu*SystemBase.SnRef/SNom else -PPcc0Pu*SystemBase.SnRef/SNomInitial active power at the point controlled by the PPC (either model's output terminal or external PCC) in pu (base SNom) (generator convention)
Types.ReactivePowerPuQ0Pu (from BasePCS)Start value of reactive power at converter terminal in pu (base SnRef) (receptor convention)
Types.ReactivePowerPuQControl0Pu (from BasePCS)if PPCLocal then -Q0Pu*SystemBase.SnRef/SNom else -QPcc0Pu*SystemBase.SnRef/SNomInitial reactive power at the point controlled by the PPC (either model's output terminal or external PCC) in pu (base SNom) (generator convention)
Types.VoltageModulePuU0Pu (from BasePCS)Start value of voltage magnitude at converter terminal in pu (base UNom)
Types.VoltageModulePuUControl0Pu (from BasePCS)Initial voltage amplitude at the point controlled by the PPC (either model's output terminal or external PCC) in pu (base UNom)
Types.ComplexVoltagePuuControl0Pu (from BasePCS)if PPCLocal then u0Pu else uPcc0PuInitial complex voltage to be controlled by the PPC coming either from the external bus or from the model's output terminal in pu (base UNom)
Types.VoltageModulePuUPcc0Pu (from BasePCS)1Start value of voltage magnitude at regulated bus in pu (base UNom)
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)
Plant Control
BooleanFreqFlag (from ParamsREPC)Governor response disable (0) or enable (1)
BooleanRefFlag (from ParamsREPC)Plant level reactive power (0) or voltage control (1)
BooleanVCompFlag (from ParamsREPC)Reactive droop (0) or line drop compensation (1) if RefFlag true
Types.PerUnitDbdPu (from ParamsREPC)Reactive power (RefFlag = 0) or voltage (RefFlag = 1) deadband in pu (base SNom or UNom) (typical: 0..0.1)
Types.PerUnitDDn (from ParamsREPC)Down regulation droop (typical: 20..33.3)
Types.PerUnitDUp (from ParamsREPC)Up regulation droop (typical: 0)
Types.PerUnitEMaxPu (from ParamsREPC)Maximum Volt/VAR error in pu (base UNom or SNom)
Types.PerUnitEMinPu (from ParamsREPC)Minimum Volt/VAR error in pu (base UNom or SNom)
Types.PerUnitFDbd1Pu (from ParamsREPC)Overfrequency deadband for governor response in pu (base omegaNom) (typical: 0.004)
Types.PerUnitFDbd2Pu (from ParamsREPC)Underfrequency deadband for governor response in pu (base omegaNom)^ (typical: 0.004)
Types.PerUnitFEMaxPu (from ParamsREPC)Maximum frequency error in droop regulator in pu (base omegaNom)
Types.PerUnitFEMinPu (from ParamsREPC)Minimum frequency error in droop regulator in pu (base omegaNom)
Types.PerUnitKc (from ParamsREPC)Reactive droop when VCompFlag = 0
Types.PerUnitKi (from ParamsREPC)Volt/VAR regulator integral gain
Types.PerUnitKig (from ParamsREPC)Droop regulator integral gain
Types.PerUnitKp (from ParamsREPC)Volt/VAR regulator proportional gain
Types.PerUnitKpg (from ParamsREPC)Droop regulator proportional gain
Types.ActivePowerPuPMaxREPCPu (from ParamsREPC)Maximum plant level active power command in REPC in pu (base SNom)
Types.ActivePowerPuPMinREPCPu (from ParamsREPC)Minimum plant level active power command in REPC in pu (base SNom)
Types.ReactivePowerPuQMaxREPCPu (from ParamsREPC)Maximum plant level reactive power command in REPC in pu (base SNom)
Types.ReactivePowerPuQMinREPCPu (from ParamsREPC)Minimum plant level reactive power command in REPC in pu (base SNom)
Types.TimetFilterPC (from ParamsREPC)Voltage and reactive power filter time constant in s (typical: 0.01..0.02)
Types.TimetFt (from ParamsREPC)Plant controller Q output lead time constant in s
Types.TimetFv (from ParamsREPC)Plant controller Q output lag time constant in s (typical: 0.15..5)
Types.TimetLag (from ParamsREPC)Plant controller P output lag time constant in s(typical: 0.15..5)
Types.TimetpREPC (from ParamsREPC)Active power filter time constant in REPC in s (typical: 0.01..0.02)
Types.VoltageModulePuVFrz (from ParamsREPC)Voltage for freezing Volt/VAR regulator integrator (typical: 0..0.9)
LV transformer
Types.PerUnitRLvTrPu (from ParamsLvTfo)Serial resistance of LV transformer in pu (base UNom, SNom). Including source resistance for voltage source.
Types.PerUnitXLvTrPu (from ParamsLvTfo)Serial reactance of LV transformer in pu (base UNom, SNom). Including source reactance for voltage source.
BooleanConverterLVControl (from ParamsLvTfo)If true, the converter is controlling at its output (LV side of its transformer), if false, after its transformer (MV side)
MV network + MV/HV transformer
Types.PerUnitBMvHvPu (from ParamsPCS)0Shunt susceptance of internal MV network + MV/HV transformer in pu (base UNom, SNom)
Types.PerUnitGMvHvPu (from ParamsPCS)0Shunt conductance of internal MV network + MV/HV transformer in pu (base UNom, SNom)
Types.PerUnitRMvHvPu (from ParamsPCS)0Serial resistance of internal MV network + MV/HV transformer in pu (base UNom, SNom)
Types.PerUnitXMvHvPu (from ParamsPCS)0Serial reactance of internal MV network + MV/HV transformer in pu (base UNom, SNom)
Types.PerUnitrTfoPu (from ParamsPCS)1Transformation ratio in pu: UWT_terminal/UWTG_terminal in no load conditions
BooleanPPCLocal (from ParamsPCS)If true, the Power Park Control is controlling at model's output terminal, if false, at a remote terminal using external measurements
Operating point
Types.ActivePowerPuPPcc0Pu (from BasePCS)0Initial active power at the external bus controlled by the PPC (used when PPCLocal = false, meaning the PCS is defined outside of the model) in pu (base UNom, SnRef) (receptor convention)
Types.ReactivePowerPuQPcc0Pu (from BasePCS)0Initial reactive power at the external bus controlled by the PPC (used when PPCLocal = false, meaning the PCS is defined outside of the model) in pu (base UNom, SnRef) (receptor convention)
Types.ComplexVoltagePuuPcc0Pu (from BasePCS)Initial voltage module at the external bus controlled by the PPC (used when PPCLocal = false, meaning the PCS is defined outside of the model) in pu (base UNom)

Connectors

TypeNameDefaultDescription
Modelica.Blocks.Interfaces.RealInputomegaRefPu (from BaseBESSCurrentSource)
Modelica.Blocks.Interfaces.RealInputPAuxPu (from BaseBESSCurrentSource)Auxiliary input in pu (base SNom) (generator convention)
Modelica.Blocks.Interfaces.RealInputPFaRef (from BaseBESSCurrentSource)Power factor angle reference in rad
Dynawo.Connectors.ACPowerterminal (from BasePCS)
Modelica.Blocks.Interfaces.RealInputPPccPu (from BasePCS)Active power setpoint at regulated bus in pu (receptor convention) (base SnRef) (used only when PPCLocal = false)
Modelica.Blocks.Interfaces.RealInputQPccPu (from BasePCS)Reactive power setpoint at regulated bus in pu (receptor convention) (base SnRef) (used only when PPCLocal = false)
Modelica.ComplexBlocks.Interfaces.ComplexInputuPccPu (from BasePCS)Complex voltage at PPC regulated bus in pu (base UNom)
Modelica.Blocks.Interfaces.RealOutputUControlPu (from BasePCS)Voltage amplitude at the point controlled by the PPC (either model's output terminal or external PCC) in pu (base UNom)
Modelica.Blocks.Interfaces.RealInputPRefPuActive power reference in pu (generator convention) (base SNom)
Modelica.Blocks.Interfaces.RealInputQRefPuReactive power reference in pu (generator convention) (base SNom)
Modelica.Blocks.Interfaces.RealInputURefPuVoltage setpoint for plant level control in pu (base UNom)

Components

TypeNameDefaultDescription
Dynawo.Electrical.Controls.WECC.REEC.REECcreecC (from BaseBESSCurrentSource)
Dynawo.Electrical.Controls.WECC.REGC.REGCaregcA (from BaseBESSCurrentSource)
Controls.PLL.PLLpll (from BaseBESSCurrentSource)
Sources.InjectorIDQinjector (from BaseBESSCurrentSource)
Dynawo.Electrical.Controls.WECC.Utilities.MeasurementsLvMeasurements (from BaseBESSCurrentSource)
Sources.IEC.BaseConverters.ElecSystemLvTfo (from BaseBESSCurrentSource)
Modelica.Blocks.Logical.Switchswitch1 (from BasePCS)
Modelica.ComplexBlocks.ComplexMath.ComplexToRealcomplexToReal (from BasePCS)
Modelica.Blocks.Logical.Switchswitch3 (from BasePCS)
Modelica.Blocks.Logical.Switchswitch2 (from BasePCS)
Modelica.Blocks.Sources.BooleanConstantbooleanConstant (from BasePCS)
Modelica.ComplexBlocks.ComplexMath.RealToComplexi (from BasePCS)
Modelica.ComplexBlocks.ComplexMath.RealToComplexu (from BasePCS)
Modelica.Blocks.Logical.Switchswitch4 (from BasePCS)
Modelica.ComplexBlocks.ComplexMath.ComplexToRealcomplexToReal1 (from BasePCS)
Dynawo.Electrical.Controls.WECC.Utilities.MeasurementsHvMeasurements (from BasePCS)
Modelica.Blocks.Sources.RealExpressionQRegPuSnExtern (from BasePCS)
Modelica.Blocks.Logical.Switchswitch (from BasePCS)
Modelica.Blocks.Logical.Switchswitch5 (from BasePCS)
Modelica.Blocks.Sources.RealExpressionPRegPuSnExtern (from BasePCS)
Modelica.Blocks.Math.Gaingain (from BasePCS)
Modelica.Blocks.Math.Gaingain1 (from BasePCS)
Modelica.ComplexBlocks.ComplexMath.ComplexToRealcomplexToReal2 (from BasePCS)
Modelica.ComplexBlocks.ComplexMath.ComplexToRealcomplexToReal3 (from BasePCS)
Dynawo.Electrical.Transformers.TransformersFixedTap.TransformerFixedRatioHvTfo (from BasePCS)
Modelica.ComplexBlocks.Sources.ComplexExpressioncomplexExpr (from BasePCS)
Dynawo.NonElectrical.Blocks.Complex.ComplexToPolarcomplexToPolar (from BasePCS)
Dynawo.Electrical.Controls.WECC.REPC.REPCarepcA