modelPVVoltageSource3NoPlantControl

WECC PV model with a voltage source as interface with the grid (REEC-A REGC-C)

Extends from Dynawo.Electrical.Controls.WECC.Parameters.REEC.ParamsREECa (REEC type A parameters), Dynawo.Electrical.Controls.WECC.Parameters.ParamsLvTfo, Dynawo.Electrical.Photovoltaics.WECC.BaseClasses.BasePVVoltageSourceC (Base model for WECC PV with a voltage source as interface with the grid (REGC-C)).

Information

This block contains the generic WECC PV model according to (in case page cannot be found, copy link in browser): https://www.wecc.biz/Reliability/WECC%20Solar%20Plant%20Dynamic%20Modeling%20Guidelines.pdf

Parameters

TypeNameDefaultDescription
Types.AngularVelocityPuomegaRefWTGQ0Pu (from ParamsREECa)Start value of reference angular frequency of torque control in pu (base omegaNom)
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.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.TimetE (from ParamsVSourceRef)Emulated delay in converter controls in s (cannot be zero, typical: 0.02..0.05)
Types.PerUnitRSourcePu (from ParamsVSourceRef)Source resistance in pu (base UNom, SNom)
Types.PerUnitXSourcePu (from ParamsVSourceRef)Source reactance in pu (base UNom, SNom)
Types.ComplexCurrentPui0Pu (from BasePVVoltageSourceC)Start value of complex current at terminal in pu (base UNom, SnRef) (receptor convention)
Types.ComplexPerUnitiConv0Pu (from BasePVVoltageSourceC)Start value of complex current at converter terminal in pu (base UNom, SNom) (generator convention)
Types.ComplexPerUnitiInj0Pu (from BasePVVoltageSourceC)Start value of complex current at injector in pu (base UNom, SNom) (generator convention)
Types.ComplexPerUnitiSource0Pu (from BasePVVoltageSourceC)Start value of complex current at source in pu (base UNom, SNom) (generator convention)
Types.ActivePowerPuPInj0Pu (from BasePVVoltageSourceC)Start value of active power at injector terminal in pu (generator convention) (base SNom)
Types.ReactivePowerPuQInj0Pu (from BasePVVoltageSourceC)Start value of reactive power at injector terminal in pu (generator convention) (base SNom)
Types.PerUnitUdInj0Pu (from BasePVVoltageSourceC)Start value of d-axis voltage at injector in pu (base UNom)
Types.ComplexPerUnituInj0Pu (from BasePVVoltageSourceC)Start value of complex voltage at injector in pu (base UNom)
Types.AngleUPhaseConv0 (from BasePVVoltageSourceC)Value of voltage phase angle at converter terminal in rad
Types.PerUnitUqInj0Pu (from BasePVVoltageSourceC)Start value of q-axis voltage at injector in pu (base UNom)
Types.ComplexPerUnituSource0Pu (from BasePVVoltageSourceC)Start value of complex voltage at source in pu (base UNom)
Electrical Control › REECa
Types.PerUnitVDLIp11 (from ParamsREECa)
Types.PerUnitVDLIp12 (from ParamsREECa)
Types.PerUnitVDLIp21 (from ParamsREECa)
Types.PerUnitVDLIp22 (from ParamsREECa)
Types.PerUnitVDLIp31 (from ParamsREECa)
Types.PerUnitVDLIp32 (from ParamsREECa)
Types.PerUnitVDLIp41 (from ParamsREECa)
Types.PerUnitVDLIp42 (from ParamsREECa)
Types.PerUnitVDLIq11 (from ParamsREECa)
Types.PerUnitVDLIq12 (from ParamsREECa)
Types.PerUnitVDLIq21 (from ParamsREECa)
Types.PerUnitVDLIq22 (from ParamsREECa)
Types.PerUnitVDLIq31 (from ParamsREECa)
Types.PerUnitVDLIq32 (from ParamsREECa)
Types.PerUnitVDLIq41 (from ParamsREECa)
Types.PerUnitVDLIq42 (from ParamsREECa)
Types.PerUnit[:,:]VDLIpPoints (from ParamsREECa)[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 ParamsREECa)[VDLIq11, VDLIq12; VDLIq21, VDLIq22; VDLIq31, VDLIq32; VDLIq41, VDLIq42]Pair of points for voltage-dependent reactive current limitation piecewise linear curve [u1,y1; u2,y2;...]
Types.TimetHoldIpMax (from ParamsREECa)Time delay for which the active current limit (ipMaxPu) is held after voltage dip in s
Types.TimetHoldIq (from ParamsREECa)Absolute value of tHoldIq defines seconds to hold current injection after voltage dip ended. tHoldIq > 0 for constant, 0 for no injection after voltage dip, tHoldIq < 0 for voltage-dependent injection (typical: -1 .. 1 s)
Types.PerUnitIqFrzPu (from ParamsREECa)Constant reactive current injection value in pu (base UNom, SNom) (typical: -0.1 .. 0.1 pu)
BooleanPFlag (from ParamsREECa)Power reference flag: const. Pref (0) or consider generator speed (1)
Types.VoltageModulePuVRef1Pu (from ParamsREECa)User-defined reference/bias on the inner-loop voltage control in pu (base UNom) (typical: 0 pu)
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)
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)
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 › REGCc
Types.PerUnitKii (from ParamsREGCc)Integrator gain of the inner current loop
Types.PerUnitKip (from ParamsREGCc)Proportional gain of the inner current loop
BooleanRateFlag (from ParamsREGCc)Active current (=false) or active power (=true) ramp (if unkown set to false)

Connectors

TypeNameDefaultDescription
Modelica.Blocks.Interfaces.RealInputPFaRef (from BasePVVoltageSourceC)Power factor angle reference in rad
Modelica.Blocks.Interfaces.RealInputomegaRefPu (from BasePVVoltageSourceC)Frequency reference in pu (base omegaNom)
Dynawo.Connectors.ACPowerterminal
Modelica.Blocks.Interfaces.RealInputPConvRefPuActive power reference in pu (generator convention) (base SNom)
Modelica.Blocks.Interfaces.RealInputQConvRefPuReactive power reference in pu (generator convention) (base SNom)
Modelica.Blocks.Interfaces.RealOutputUConvPuVoltage amplitude at converter terminal in pu (base UNom)

Components

TypeNameDefaultDescription
Dynawo.Electrical.Controls.WECC.REGC.REGCcwecc_regc (from BasePVVoltageSourceC)
Dynawo.Electrical.Controls.PLL.PLLpll (from BasePVVoltageSourceC)
Dynawo.Electrical.Sources.InjectorURIinjector (from BasePVVoltageSourceC)
Dynawo.Electrical.Lines.Linesource (from BasePVVoltageSourceC)
Dynawo.Electrical.Sources.IEC.BaseConverters.ElecSystemLvTfo (from BasePVVoltageSourceC)
Dynawo.Electrical.Controls.WECC.Utilities.MeasurementsLvMeasurements (from BasePVVoltageSourceC)
Dynawo.Electrical.Controls.WECC.Utilities.MeasurementsSourceMeasurements (from BasePVVoltageSourceC)
Dynawo.Electrical.Controls.WECC.REEC.REECawecc_reec
Modelica.Blocks.Sources.ConstantomegaGPu