modelWT4ACurrentSource
WECC Wind Turbine model with a simplified drive train model (dual-mass model), without the plant controller and with a current source as interface with the grid
Extends from Dynawo.Electrical.Controls.WECC.Parameters.ParamsLvTfo, Dynawo.Electrical.Wind.WECC.BaseClasses.BaseWT4A (Partial base model for WECC Wind Turbine 4A).
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.
- Simplified drive train model, dual-mass model.
- Generator control.
- Injector (id,iq).
Notice that in this model and contrary to the norm model, the plant controller is not included.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Types.PerUnit | RPu (from ParamsLvTfo) | if ConverterLVControl then 1e-5 else RLvTrPu | Serial resistance between injector output and LvTfo in pu (base UNom, SNom). Including source resistance for voltage source. |
| Types.PerUnit | XPu (from ParamsLvTfo) | if ConverterLVControl then 1e-5 else XLvTrPu | Serial reactance between injector output and LvTfo in pu (base UNom, SNom). Including source resistance for voltage source. |
| Types.ApparentPowerModule | SNom (from ParamsREEC) | Nominal apparent power in MVA | |
| Types.CurrentModulePu | Id0Pu (from ParamsREEC) | Start value of d-component current at injector terminal in pu (generator convention) (base SNom, UNom) | |
| Types.CurrentModulePu | Iq0Pu (from ParamsREEC) | Start value of q-component current at injector terminal in pu (generator convention) (base SNom, UNom) | |
| Types.PerUnit | PF0 (from ParamsREEC) | Start value of power factor | |
| Types.ActivePowerPu | PConv0Pu (from ParamsREEC) | Start value of active power at converter terminal in pu (generator convention) (base SNom) | |
| Types.ReactivePowerPu | QConv0Pu (from ParamsREEC) | Start value of reactive power at converter terminal in pu (generator convention) (base SNom) | |
| Types.VoltageModulePu | UInj0Pu (from ParamsREEC) | Start value of voltage magnitude at injector terminal in pu (base UNom) | |
| Types.ComplexPerUnit | s0Pu (from ParamsREEC) | Start value of complex apparent power at terminal in pu (base SnRef) (receptor convention) | |
| Types.ComplexVoltagePu | u0Pu (from ParamsREEC) | Start value of complex voltage at terminal in pu (base UNom) | |
| Types.VoltageModulePu | UConv0Pu (from ParamsREEC) | Start value of voltage module at converter terminal in pu (base UNom) | |
| Types.ComplexPerUnit | uConv0Pu (from ParamsREEC) | Start value of complex voltage at converter terminal in pu (base UNom) | |
| Types.ComplexCurrentPu | i0Pu (from BaseWT4) | Start value of complex current at terminal in pu (base UNom, SnRef) (receptor convention) | |
| Types.ComplexPerUnit | iConv0Pu (from BaseWT4) | Start value of complex current at converter terminal in pu (base UNom, SNom) (generator convention) | |
| Types.ActivePowerPu | PInj0Pu (from BaseWT4) | Start value of active power at injector terminal in pu (generator convention) (base SNom) | |
| Types.ReactivePowerPu | QInj0Pu (from BaseWT4) | Start value of reactive power at injector terminal in pu (generator convention) (base SNom) | |
| Types.ComplexPerUnit | uInj0Pu (from BaseWT4) | Start value of complex voltage at injector in pu (base UNom) | |
| Types.Angle | UPhase0 (from BaseWT4) | Start value of voltage phase angle at regulated bus in rad | |
| Types.Angle | UPhaseConv0 (from BaseWT4) | Value of voltage phase angle at converter terminal in rad | |
| LV transformer | |||
| Types.PerUnit | RLvTrPu (from ParamsLvTfo) | Serial resistance of LV transformer in pu (base UNom, SNom). Including source resistance for voltage source. | |
| Types.PerUnit | XLvTrPu (from ParamsLvTfo) | Serial reactance of LV transformer in pu (base UNom, SNom). Including source reactance for voltage source. | |
| Boolean | ConverterLVControl (from ParamsLvTfo) | If true, the converter is controlling at its output (LV side of its transformer), if false, after its transformer (MV side) | |
| Drive train control | |||
| Types.Time | Ht (from ParamsWTGT) | Turbine Inertia in s (typical: 5 s) | |
| Types.Time | Hg (from ParamsWTGT) | Generator Inertia in s (typical: 1 s) | |
| Types.PerUnit | Dshaft (from ParamsWTGT) | Damping coefficient in pu (typical: 1.5 pu, base SNom, omegaNom) | |
| Types.PerUnit | Kshaft (from ParamsWTGT) | Spring constant in pu (typical: 200 pu, base SNom, omegaNom) | |
| Types.Time | tpWTGTb (from ParamsWTGTb) | Lag time constant in WTGTb in s | |
| Initialization | |||
| Types.AngularVelocityPu | omegaRefWTGQ0Pu (from ParamsWTGT) | Start value of reference angular frequency of torque control in pu (base omegaNom) | |
| PLL | |||
| Types.PerUnit | KiPLL (from ParamsPLL) | PLL integrator gain | |
| Types.PerUnit | KpPLL (from ParamsPLL) | PLL proportional gain | |
| Types.AngularVelocityPu | OmegaMaxPu (from ParamsPLL) | Upper frequency limit in pu (base omegaNom) | |
| Types.AngularVelocityPu | OmegaMinPu (from ParamsPLL) | Lower frequency limit in pu (base omegaNom) | |
| Electrical Control › REEC | |||
| Boolean | PfFlag (from ParamsREEC) | Power factor flag: Q control (0) or pf control(1) | |
| Boolean | PQFlag (from ParamsREEC) | Q/P priority: Q priority (0) or P priority (1) | |
| Boolean | QFlag (from ParamsREEC) | Q control flag: const. pf or Q ctrl (0) or voltage/Q (1) | |
| Boolean | VFlag (from ParamsREEC) | Voltage control flag: voltage control (0) or Q ctrl (1) | |
| Types.VoltageModulePu | Dbd1Pu (from ParamsREEC) | Overvoltage deadband for reactive current injection in pu (base UNom) (typical: -0.1..0) | |
| Types.VoltageModulePu | Dbd2Pu (from ParamsREEC) | Undervoltage deadband for reactive current injection in pu (base UNom) (typical: 0..0.1) | |
| Types.PerUnit | DPMaxPu (from ParamsREEC) | Active power upper rate limit in pu/s (base SNom) (typical: > 0.1, set to 99 to disable) | |
| Types.PerUnit | DPMinPu (from ParamsREEC) | Active power lower rate limit in pu/s (base SNom) (typical: < -0.1, set to -99 to disable) | |
| Types.CurrentModulePu | IMaxPu (from ParamsREEC) | Maximal apparent current magnitude in pu (base UNom, SNom) (typical: 1..2) | |
| Types.PerUnit | Iqh1Pu (from ParamsREEC) | Maximum reactive current injection (typical: 1..1.1) in pu (base UNom, SNom) | |
| Types.PerUnit | Iql1Pu (from ParamsREEC) | Minimum reactive current injection (typical: -1.1..-1) in pu (base UNom, SNom) | |
| Types.PerUnit | Kqi (from ParamsREEC) | Integrator gain local reactive power PI controller | |
| Types.PerUnit | Kqp (from ParamsREEC) | Proportional gain local reactive power PI controller | |
| Types.PerUnit | Kqv (from ParamsREEC) | K-Factor, reactive current injection gain (typical: 0..10) | |
| Types.PerUnit | Kvi (from ParamsREEC) | Integrator gain local voltage PI controller | |
| Types.PerUnit | Kvp (from ParamsREEC) | Proportional gain local voltage PI controller | |
| Types.ActivePowerPu | PMaxREECPu (from ParamsREEC) | Active power upper limit in REEC in pu (base SNom) (typical: 1) | |
| Types.ActivePowerPu | PMinREECPu (from ParamsREEC) | Active power lower limit in REEC in pu (base SNom) (typical: 0) | |
| Types.ReactivePowerPu | QMaxREECPu (from ParamsREEC) | Reactive power upper limit, when vFlag == 1 in REEC in pu (base SNom) | |
| Types.ReactivePowerPu | QMinREECPu (from ParamsREEC) | Reactive power lower limit, when vFlag == 1 in REEC in pu (base SNom) | |
| Types.Time | tIq (from ParamsREEC) | Filter time constant reactive current in s(typical: 0.01..0.02) | |
| Types.Time | tRv (from ParamsREEC) | Filter time constant terminal voltage in s(typical: 0.01..0.02) | |
| Types.Time | tpREEC (from ParamsREEC) | Active power filter time constant in REEC in s (typical: 0.1..0.2) | |
| Types.Time | tPord (from ParamsREEC) | Filter time constant inverter active power in s | |
| Types.VoltageModulePu | VDipPu (from ParamsREEC) | Low voltage condition trigger voltage for FRT in pu (base UNom) (typical: 0..0.9) | |
| Types.VoltageModulePu | VMaxPu (from ParamsREEC) | Maximum voltage at inverter terminal in pu (base UNom) (typical: 1.05..1.15) | |
| Types.VoltageModulePu | VMinPu (from ParamsREEC) | Minimum voltage at inverter terminal in pu (base UNom) (typical: 0.85..0.95) | |
| Types.VoltageModulePu | VRef0Pu (from ParamsREEC) | Reference voltage for reactive current injection in pu (base UNom) (typical: 0.95..1.05) | |
| Types.VoltageModulePu | VUpPu (from ParamsREEC) | High voltage condition trigger voltage for FRT in pu (base UNom) (typical: 1.1..1.3) | |
| Electrical Control › REECa | |||
| Types.PerUnit | VDLIp11 (from ParamsREECa) | ||
| Types.PerUnit | VDLIp12 (from ParamsREECa) | ||
| Types.PerUnit | VDLIp21 (from ParamsREECa) | ||
| Types.PerUnit | VDLIp22 (from ParamsREECa) | ||
| Types.PerUnit | VDLIp31 (from ParamsREECa) | ||
| Types.PerUnit | VDLIp32 (from ParamsREECa) | ||
| Types.PerUnit | VDLIp41 (from ParamsREECa) | ||
| Types.PerUnit | VDLIp42 (from ParamsREECa) | ||
| Types.PerUnit | VDLIq11 (from ParamsREECa) | ||
| Types.PerUnit | VDLIq12 (from ParamsREECa) | ||
| Types.PerUnit | VDLIq21 (from ParamsREECa) | ||
| Types.PerUnit | VDLIq22 (from ParamsREECa) | ||
| Types.PerUnit | VDLIq31 (from ParamsREECa) | ||
| Types.PerUnit | VDLIq32 (from ParamsREECa) | ||
| Types.PerUnit | VDLIq41 (from ParamsREECa) | ||
| Types.PerUnit | VDLIq42 (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.Time | tHoldIpMax (from ParamsREECa) | Time delay for which the active current limit (ipMaxPu) is held after voltage dip in s | |
| Types.Time | tHoldIq (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.PerUnit | IqFrzPu (from ParamsREECa) | Constant reactive current injection value in pu (base UNom, SNom) (typical: -0.1 .. 0.1 pu) | |
| Boolean | PFlag (from ParamsREECa) | Power reference flag: const. Pref (0) or consider generator speed (1) | |
| Types.VoltageModulePu | VRef1Pu (from ParamsREECa) | User-defined reference/bias on the inner-loop voltage control in pu (base UNom) (typical: 0 pu) | |
| Generator Converter › REGC | |||
| Types.PerUnit | IqrMaxPu (from ParamsREGC) | Maximum rate-of-change of reactive current after fault in pu (base UNom, SNom) (typical: 1..999) | |
| Types.PerUnit | IqrMinPu (from ParamsREGC) | Minimum rate-of-change of reactive current after fault in pu (base UNom, SNom) (typical: -999..-1) | |
| Types.PerUnit | RrpwrPu (from ParamsREGC) | Active current (or power if RateFlag = true) recovery rate in pu/s (base UNom, SNom) (typical: 1..20) | |
| Types.Time | tFilterGC (from ParamsREGC) | Filter time constant of terminal voltage in s(Cannot be set to zero, typical: 0.02..0.05) | |
| Generator Converter › REGCa | |||
| Types.Time | tG (from ParamsREGCa) | Emulated delay in converter controls in s(Cannot be zero, typical: 0.02..0.05) | |
| Types.PerUnit | brkpt (from ParamsREGCa) | LVPL breakpoint in pu (base UNom) | |
| Types.PerUnit | lvpl1 (from ParamsREGCa) | LVPL gain breakpoint in pu | |
| Boolean | Lvplsw (from ParamsREGCa) | Low voltage power logic switch: 1-enabled/0-disabled | |
| Types.PerUnit | zerox (from ParamsREGCa) | LVPL zero crossing in pu (base UNom) | |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Blocks.Interfaces.RealInput | PFaRef (from BaseWT4) | Power factor angle reference in rad | |
| Modelica.Blocks.Interfaces.RealInput | omegaRefPu (from BaseWT4) | Frequency reference in pu (base omegaNom) | |
| Dynawo.Connectors.ACPower | terminal | ||
| Modelica.Blocks.Interfaces.RealInput | PConvRefPu | Active power setpoint at injector terminal in pu (generator convention) (base SNom) | |
| Modelica.Blocks.Interfaces.RealInput | QConvRefPu | Reactive power setpoint at injector terminal in pu (generator convention) (base SNom) | |
| Modelica.Blocks.Interfaces.RealOutput | UConvPu | Voltage amplitude at converter terminal in pu (base UNom) |