modelWT3CurrentSource2

WECC Wind Turbine model without plant controller and with a current source as interface with the grid and the mechanical controllers

Extends from Dynawo.Electrical.Controls.PLL.ParamsPLL, Dynawo.Electrical.Controls.WECC.Parameters.REEC.ParamsREEC (Common REEC parameters), Dynawo.Electrical.Controls.WECC.Parameters.REEC.ParamsREECa (REEC type A parameters), Dynawo.Electrical.Controls.WECC.Parameters.REGC.ParamsREGC (Common REGC parameters), Dynawo.Electrical.Controls.WECC.Parameters.REGC.ParamsREGCa (REGC type A parameters), Dynawo.Electrical.Controls.WECC.Parameters.Mechanical.ParamsWTGP, Dynawo.Electrical.Controls.WECC.Parameters.Mechanical.ParamsWTGPb, Dynawo.Electrical.Controls.WECC.Parameters.Mechanical.ParamsWTGAa, Dynawo.Electrical.Controls.WECC.Parameters.Mechanical.ParamsWTGQa, Dynawo.Electrical.Controls.WECC.Parameters.Mechanical.ParamsWTGT, Dynawo.Electrical.Controls.WECC.Parameters.ParamsLvTfo.

Information

This block contains the generic WECC WT model according to (in case page cannot be found, copy link in browser): 
https://www.wecc.org/Reliability/WECC-Second-Generation-Wind-Turbine-Models-012314.pdf

The overall model is structured as follows:

  • Main model: WECC_Wind with terminal connection and measurement inputs for P/Q/U/I. 
  • Electrical inverter control.
  • Generator control. 
  • Injector (id,iq).
  • Torque control.
  • Pitch angle control.
  • Aero-Dynamic model.
  • Drive-train.
The only difference with the model WT3CurrentSource1 is the change of the pitch controller model, this one offers more flexibility with the limits of the integrators.

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.AngularVelocityPuomegaRefWTGQ0Pu (from ParamsREECa)Start value of reference angular frequency of torque control in pu (base omegaNom)
Types.AngleDegreeTheta0 (from ParamsWTGP)10Initial pitch angle in degree
Types.ActivePowerPuPm0Pu (from ParamsWTGAa)Initial mechanical power in pu (base SNom)
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.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.ComplexPerUnituInj0PuStart value of complex voltage at injector in pu (base UNom)
Types.AngleUPhase0Start value of voltage phase angle at regulated bus in rad
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 › 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)
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)
Pitch Control
Types.FrequencyKiw (from ParamsWTGP)Pitch controller integral gain
Types.PerUnitKpw (from ParamsWTGP)Pitch controller proportional gain
Types.FrequencyKic (from ParamsWTGP)Pitch compensation integral gain
Types.PerUnitKpc (from ParamsWTGP)Pitch Compensation proportional gain
Types.PerUnitKcc (from ParamsWTGP)Proportionnal cross-compensation gain
Types.TimetTheta (from ParamsWTGP)Pitch time constant in s
Types.AngleDegreeThetaMax (from ParamsWTGP)Maximum pitch angle limit in degree
Types.AngleDegreeThetaMin (from ParamsWTGP)Minimum pitch angle limit in degree
Types.AngularVelocityDegreeThetaRMax (from ParamsWTGP)Maximum pitch angle rate limit in degree/s
Types.AngularVelocityDegreeThetaRMin (from ParamsWTGP)Minimum pitch angle rate limit in degree/s
Types.AngleDegreeThetaWMax (from ParamsWTGPb)Maximum pitch PI controller angle limit in degree
Types.AngleDegreeThetaWMin (from ParamsWTGPb)Minimum pitch angle PI controller limit in degree
Types.AngleDegreeThetaCMax (from ParamsWTGPb)Maximum pitch compensation PI controller angle limit in degree
Types.AngleDegreeThetaCMin (from ParamsWTGPb)Minimum pitch compensation PI controller angle limit in degree
Aero-dynamic model
Types.PerUnitKa (from ParamsWTGAa)Aero-dynamic gain factor
Torque control
Types.FrequencyKip (from ParamsWTGQa)Integral gain
Types.PerUnitKpp (from ParamsWTGQa)Proportional gain
Types.PerUnitP1 (from ParamsWTGQa)1st power point for extrapolation table
Types.PerUnitSpd1 (from ParamsWTGQa)1st speed point for extrapolation table
Types.PerUnitP2 (from ParamsWTGQa)2nd power point for extrapolation table
Types.PerUnitSpd2 (from ParamsWTGQa)2nd speed point for extrapolation table
Types.PerUnitP3 (from ParamsWTGQa)3rd power point for extrapolation table
Types.PerUnitSpd3 (from ParamsWTGQa)3rd speed point for extrapolation table
Types.PerUnitP4 (from ParamsWTGQa)4th power point for extrapolation table
Types.PerUnitSpd4 (from ParamsWTGQa)4th speed point for extrapolation table
Types.PerUnitTeMaxPu (from ParamsWTGQa)Maximum torque
Types.PerUnitTeMinPu (from ParamsWTGQa)Minimum torque
BooleanTFlag (from ParamsWTGQa)Flag to specify PI controller input, if true : power control, if false : speed control
Types.TimetpWTGQa (from ParamsWTGQa)Power measurement lag time constant in WTGQa in s
Types.TimetOmegaRef (from ParamsWTGQa)Speed reference time constant ins s
Drive train control
Types.TimeHt (from ParamsWTGT)Turbine Inertia in s (typical: 5 s)
Types.TimeHg (from ParamsWTGT)Generator Inertia in s (typical: 1 s)
Types.PerUnitDshaft (from ParamsWTGT)Damping coefficient in pu (typical: 1.5 pu, base SNom, omegaNom)
Types.PerUnitKshaft (from ParamsWTGT)Spring constant in pu (typical: 200 pu, base SNom, omegaNom)
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)

Connectors

TypeNameDefaultDescription
Dynawo.Connectors.ACPowerterminal
Modelica.Blocks.Interfaces.RealInputomegaRefPuFrequency reference in pu (base omegaNom)
Modelica.Blocks.Interfaces.RealInputPConvRefPuActive power setpoint at converter terminal in pu (generator convention) (base SNom)
Modelica.Blocks.Interfaces.RealInputPFaRefPower factor angle reference in rad
Modelica.Blocks.Interfaces.RealInputPmRefPuReference mechanical power at optimal pitch angle in pu (base SNom)
Modelica.Blocks.Interfaces.RealInputQConvRefPuReactive power setpoint at converter terminal in pu (generator convention) (base SNom)
Modelica.Blocks.Interfaces.RealOutputUConvPuVoltage amplitude at converter terminal in pu (base UNom)

Components

TypeNameDefaultDescription
Dynawo.Electrical.Controls.WECC.Mechanical.WTGQawecc_wtgq
Dynawo.Electrical.Controls.WECC.Mechanical.WTGTawecc_wtgt
Dynawo.Electrical.Controls.WECC.REGC.REGCawecc_regc
Dynawo.Electrical.Sources.InjectorIDQinjector
Dynawo.Electrical.Controls.PLL.PLLpll
Dynawo.Electrical.Controls.WECC.REEC.REECawecc_reec
Dynawo.Electrical.Controls.WECC.Mechanical.WTGPbwecc_wtgp
Dynawo.Electrical.Controls.WECC.Mechanical.WTGAawecc_wtga
Dynawo.Electrical.Sources.IEC.BaseConverters.ElecSystemLvTfo
Dynawo.Electrical.Controls.WECC.Utilities.MeasurementsLvMeasurements