modelREECA1
Extends from OpenIPSL.Electrical.Renewables.PSSE.ElectricalController.BaseClasses.BaseREECA (Base renewable energy electrical controller model A).
Information
The REECA1 component used to represent the electrical controls of wind turbine generation. The electrical controller actuates on the active and reactive power reference from either the plant controller component or from power flow power reference values (in the case where there is no plant controller), with feedback variables that original from the inverter interface component, specifically terminal voltage and generator power output, and provides real (Ipcmd) and reactive current (Iqcmd) commands to the REGC type modules.
For initialization purposes, there are 5 inputs that are derived from the inverter component: initial real and reactive injection currents (IP0 and IQ0), initial terminal voltage (v_0), and initial active and reactive power injections (p_0 and q_0).
In terms of connectivity with other components to form the renewable source, the REECA1 component has six inputs, three of which are connected to the inverter component (for instance REGCA1), two more that can either be constant values from the power flow initialization or come from the connection to the plant controller, and an input (wg) that allows modeling the torscional frequencies on the turbine shaft originated from disturbances. The three REECA1 inputs that take in values from the output of the inverter model are Vt, Pgen, and Qgen while the two inputs that could potentially be constant valued or come from the plant controller are Pref, and Qext.
The modelling of such devices is based, mainly, on the following references:
- Siemens: "PSS®E Model Library" [PSSE-MODELS],
- WECC: "Wind Power Plant Dynamic Modeling Guideline" [WECCWind].
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| OpenIPSL.Types.PerUnit | Vdip | -99 | Low voltage threshold to activate reactive current injection logic (0.85 - 0.9) |
| OpenIPSL.Types.PerUnit | Vup | 99 | Voltage above which reactive current injection logic is activated (>1.1) |
| OpenIPSL.Types.Time | Trv | 0.01 | Filter time constant for voltage measurement (0.01 - 0.02) |
| OpenIPSL.Types.PerUnit | dbd1 | -0.05 | Voltage error dead band lower threshold (-0.1 - 0) |
| OpenIPSL.Types.PerUnit | dbd2 | 0.05 | Voltage error dead band upper threshold (0 - 0.1) |
| Real | Kqv | 0 | Reactive current injection gain during over and undervoltage conditions (0 - 10) |
| OpenIPSL.Types.PerUnit | Iqh1 | 1.05 | Upper limit on reactive current injection Iqinj (1 - 1.1) |
| OpenIPSL.Types.PerUnit | Iql1 | -1.05 | Lower limit on reactive current injection Iqinj (-1.1 - 1) |
| OpenIPSL.Types.PerUnit | vref0 | 0 | User defined voltage reference (0.95 - 1.05) |
| OpenIPSL.Types.PerUnit | Iqfrz | 0.15 | Value at which Iqinj is held for Thld seconds following a voltage dip if Thld > 0 |
| OpenIPSL.Types.Time | Thld | 0 | Time for which Iqinj is held at Iqfrz after voltage dip returns to zero |
| OpenIPSL.Types.Time | Tp | 0.05 | Filter time constant for electrical power (0.01 - 0.1) |
| OpenIPSL.Types.PerUnit | Qmax | 0.4 | Upper limits of the limit for reactive power regulator (0.4 - 1.0) |
| OpenIPSL.Types.PerUnit | Qmin | -0.4 | Lower limits of the limit for reactive power regulator (-1.0 - -0.4) |
| OpenIPSL.Types.PerUnit | Vmax | 1.1 | Maximum limit for voltage control (1.05 - 1.1) |
| OpenIPSL.Types.PerUnit | Vmin | 0.9 | Lower limits of input signals (0.9 - 0.95) |
| Real | Kqp | 0 | Reactive power regulator proportional gain (No predefined range) |
| Real | Kqi | 0.1 | Reactive power regulator integral gain (No predefined range) |
| Real | Kvp | 0 | Voltage regulator proportional gain (No predefined range) |
| Real | Kvi | 120 | Voltage regulator integral gain (No predefined range) |
| OpenIPSL.Types.PerUnit | Vbias | 0 | User-defined reference/bias on the inner-loop voltage control (No predefined range) |
| OpenIPSL.Types.Time | Tiq | 0.02 | Time constant on lag delay (0.01 - 0.02) |
| Real | dPmax | 99 | Power reference maximum ramp rate (No predefined range) |
| Real | dPmin | -99 | Lower limits of input signals (No predefined range) |
| OpenIPSL.Types.PerUnit | Pmax | 1 | Maximum power limit |
| OpenIPSL.Types.PerUnit | Pmin | 0 | Minimum power limit |
| OpenIPSL.Types.PerUnit | Imax | 1.7 | Maximum limit on total converter current (1.1 - 1.3) |
| OpenIPSL.Types.Time | Tpord | 0.04 | Power filter time constant (0.01 - 0.02) |
| OpenIPSL.Types.PerUnit | Vq1 | 0.29 | Reactive Power V-I pair, voltage (user defined) |
| OpenIPSL.Types.PerUnit | Iq1 | 1.25 | Reactive Power V-I pair, current (user defined) |
| OpenIPSL.Types.PerUnit | Vq2 | 1.33 | Reactive Power V-I pair, voltage (user defined) |
| OpenIPSL.Types.PerUnit | Iq2 | 0.00 | Reactive Power V-I pair, current (user defined) |
| OpenIPSL.Types.PerUnit | Vq3 | 1.33 | Reactive Power V-I pair, voltage (user defined) |
| OpenIPSL.Types.PerUnit | Iq3 | 0.00 | Reactive Power V-I pair, current (user defined) |
| OpenIPSL.Types.PerUnit | Vq4 | 1.33 | Reactive Power V-I pair, voltage (user defined) |
| OpenIPSL.Types.PerUnit | Iq4 | 0.00 | Reactive Power V-I pair, current (user defined) |
| OpenIPSL.Types.PerUnit | Vp1 | 0.00 | Real Power V-I pair, voltage (user defined) |
| OpenIPSL.Types.PerUnit | Ip1 | 1.15 | Real Power V-I pair, current (user defined) |
| OpenIPSL.Types.PerUnit | Vp2 | 1.1 | Real Power V-I pair, voltage (user defined) |
| OpenIPSL.Types.PerUnit | Ip2 | 1.24 | Real Power V-I pair, current (user defined) |
| OpenIPSL.Types.PerUnit | Vp3 | 2 | Real Power V-I pair, voltage (user defined) |
| OpenIPSL.Types.PerUnit | Ip3 | 1.24 | Real Power V-I pair, current (user defined) |
| OpenIPSL.Types.PerUnit | Vp4 | 2 | Real Power V-I pair, voltage (user defined) |
| OpenIPSL.Types.PerUnit | Ip4 | 1.24 | Real Power V-I pair, current (user defined) |
| Control | |||
| Boolean | pfflag (from BaseREECA) | true | Constant output value |
| Boolean | vflag (from BaseREECA) | true | Constant output value |
| Boolean | qflag (from BaseREECA) | true | Constant output value |
| Boolean | pqflag (from BaseREECA) | true | Constant output value |
| Boolean | pflag (from BaseREECA) | true | Constant output value |