Documentation Home Page ◇ HYPERSIM Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.
REEC_A
Description
The Renewable Energy Electrical Controller – Type A (REEC_A) is a WECC standard dynamic model used to represent the electrical control of inverter-based resources (IBRs) such as photovoltaic (PV) plants, wind power plants (Type 3/4), and battery energy storage systems (BESS) in positive-sequence stability studies. It regulates current, voltage, and reactive power using measurements at the Point of Measurement (POM), while tracking voltage and reactive power objectives defined at the Point of Interconnection (POI). The block model mainly contains three parts:
Active current controls, which generate the active current command Ipcmd
Reactive current controls, which generate the reactive current command Iqcmd
The converter current limit logic, which limits the active and reactive current to within the ratings of the converter
Active power control
The control path is relatively simple. It is essentially a straight pass through from the upstream plant controller through the electrical controls to the generator/converter. There is a single time constant and a set of limits to emulate the control delay and limits. The only other aspect is the flag PFlag. PFlag = 0 or PFlag = 1, the selection of the flag depends on whether the input connected to the controller is power or torque.
Reactive Power Control
There are several options for reactive power control:
Control mode | Flag settings | ||
|---|---|---|---|
PfFlag | QFlag | VFlag | |
Local constant Q control | 0 | 0 | 1 or 0 (irrelevant) |
Local constant power factor (pf) control | 1 | 0 | 1 or 0 (irrelevant) |
Local terminal voltage control | 0 | 1 | 0 |
Local coordinated Q/V control | 0 | 1 | 1 |
In addition to the above, there is a separate proportional, with deadband, current injection control, which can be used either as proportional voltage control during a voltage dip (deadband set to zero) or a proportional current injection with deadband during a voltage dip. To disable this path, Kqv can be set to zero, or Vup and Vdip set to, for example, 2 and 0, respectively.
The parameters Iqfrz and Thld can be used in association with this current injection loop to create various state transitions, as shown in the following figure.
It is noted that Thld could be either zero, or less than zero, or greater than zero.
If Thld > 0, then once voltage_dip (voltage_dip is a flag which is set and reset in the model. Voltage_dip is 0 if the Vdip<VT<Vup, else it is 1) becomes 0, Iqinj is held at Iqfrz for Thld seconds.
If Thld < 0, then once voltage_dip goes to 0, Iqinj remains state (equal to Iqv) for Thld seconds.
If Thld = 0, then Iqinj goes back to zero as soon as Voltage_dip becomes 0.
There is also a parameter, Thld2, when set to a non-zero value, will hold the Ipmax command at the value it has been frozen at during a voltage dip, after the fault clears. That is, after voltage_dip returns to 0 following clearing a fault, then Ipmax calculated during the fault remains fixed for Thld2 seconds. Then, the Ipmax calculation continues normally.
Current limit logic
In its most basic form, the current limit is a semicircle around quadrants 1 and 4. That is, only positive active current is allowed (Ipmin = 0) since this is a model for a generator, and the total current must be less than or equal to Imax. The selection of the Pqflag determines whether priority is given to active or reactive current [1].
Mask and Parameters
General Parameters
REEC_A diagram
Voltage, Q and PF Control
Parameter | Unit | Description | Variable = {Possible Values} |
|---|---|---|---|
PfFlag |
| Power factor flag |
|
VFlag |
| Voltage control flag |
|
Tp | s | Active power Pe filter time constant |
|
Vmax | pu | Voltage regulator upper output limit |
|
Vmin | pu | Voltage regulator lower output limit |
|
Vref1 | pu | User-defined reference bias. Can be set externally or remain fixed |
|
Qmax | pu | Maximum reactive power limit |
|
Qmin | pu | Minimum reactive power limit |
|
QFlag |
| Reactive power control flag |
|
Kqp | - | Proportional gain of Q regulator. Typically, zero when using voltage-based control. |
|
Kqi | 1/s | Integral gain of Q regulator |
|
Kvp | - | Voltage regulator P gain |
|
Kvi | 1/s | Voltage regulator I gain |
|
Kqv | - | Voltage error to reactive current gain. If zero, no dynamic Iq response to voltage deviation. |
|
Tiq | s | Time constant for Iq control response |
|
Reactive Current Injection During Voltage Dips
Parameter | Unit | Description |
|---|---|---|
Vup | pu | High voltage threshold for reactive current injections. If Vup > 99, Iq injection is reduced or disabled. |
Vdip | pu | Low voltage threshold for reactive current injection. Below this, the inverter starts injecting Iq for voltage support. |
dbd1 | pu | Lower bound of voltage error deadband |
dbd2 | pu | Upper bound of voltage error deadband |
Iqh1 | pu | Maximum limit of reactive current injection |
Iql1 | pu | Minimum limit of reactive current injection |
Trv | s | Voltage measurement filter time constant |
Thld | s | Time delay for which the state of the reactive current injection is held after voltage_dip returns to zero. |
Thld2 | s | Time delay for which the active current limit (Ipmax) is held after voltage_dip returns to zero for Thld2 seconds at its value during the voltage dip. |
Iqfrz | pu | Value at which reactive current injection (during a voltage-dip) is held for Thld seconds following a voltage dip if Thld > 0, p.u.; 0 to disable |
Active Power Control
Parameter | Unit | Description | Variable = {Possible Values} |
|---|---|---|---|
Pmax | pu | Maximum active power limit |
|
Pmin | pu | Minimum active power limit. Can be above zero in storage modes. |
|
Tpord | s | Power reference filter time constant |
|
dPmax | pu/s | Max power ramp-up rate |
|
dPmin | pu/s | Max power ramp-down rate |
|
PFlag |
| Active power flag |
|
Current Limit Logic
Parameter | Unit | Description | Variable = {Possible Values} |
|---|---|---|---|
Imax | pu | Maximum converter current limit (P and Q combined) |
|
PqFlag |
| P/Q priority flag for current limit |
|
Voltage-dependent Limits
The VDL1 and VDL2 characteristics are defined by 4 pairs of Vq-Iq points (pu voltage versus reactive current) and Vp-Ip points (pu voltage versus active current).
Name | Unit | Description |
|---|---|---|
Vq1 | pu | VDL1(Voltage Dependent Limit 1): Voltage Point1 |
Vq2 | pu | VDL1: Voltage Point2 |
Vq3 | pu | VDL1: Voltage Point3 |
Vq4 | pu | VDL1: Voltage Point4 |
Iq1 | pu | VDL1: Iqmax(Maximum reactive current) Point1 |
Iq2 | pu | VDL1: Iqmax Point2 |
Iq3 | pu | VDL1: Iqmax Point3 |
Iq4 | pu | VDL1: Iqmax Point4 |
Vp1 | pu | VDL2(Voltage Dependent Limit 2): Voltage Point1 |
Vp2 | pu | VDL2: Voltage Point2 |
Vp3 | pu | VDL2: Voltage Point3 |
Vp4 | pu | VDL2: Voltage Point4 |
Ip1 | pu | VDL2: Ipmax(Maximum active current) Point1 |
Ip2 | pu | VDL2: Ipmax Point2 |
Ip3 | pu | VDL2: Ipmax Point3 |
Ip4 | pu | VDL2: Ipmax Point4 |
Initial Values
Name | Unit | Description |
|---|---|---|
Vref0 | pu | Voltage reference |
Pref0 | pu | Active power reference |
Qref0 | pu | Reactive power reference |
Inputs, Outputs and Signal Available for Monitoring
Inputs
Name | Unit | Description |
|---|---|---|
Vt | pu | Terminal voltage measured at the POC |
pfaref | rad | Power factor angle reference |
Pe | pu | Active power measured at the POC |
Qgen | pu | Reactive power measured at the POC |
wg | pu | Generator speed and is set in the drive train model |
Pref | pu | Active power reference, initialized from the load flow solution or supplied by an external plant controller model |
Qext | pu | Reactive power reference, initialized from the load flow solution or supplied by an external plant controller model |
Outputs
Name | Unit | Description |
|---|---|---|
Iqcmd | pu | Reactive current command |
Ipcmd | pu | Active current command |
Acknowledgements
The development of the REEC_A block in the Smart Inverter Control Library is a contribution of CanmetENERGY at Natural Resource Canada.
Reference
[1] Model User Guide for Generic Renewable Energy System Models, EPRI, October 2023.