REEC_A

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


image-20260211-214451.png

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.

image-20251212-160224.png
State transitions in the REEC_A

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].

image-20251223-144849.png

Mask and Parameters

General Parameters

image-20260317-192833.png

REEC_A diagram

REEC_A.png

Voltage, Q and PF Control

Parameter 

Unit

Description 

Variable = {Possible Values}

Parameter 

Unit

Description 

Variable = {Possible Values}

PfFlag

 

Power factor flag

  • 1 if power factor control

  • 0 if Q control (which can be controlled by an external signal)

VFlag

 

Voltage control flag

  • 1 if Q control

  • 0 if voltage control

Tp 

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

  • 1 if voltage or Q control

  • 0 if constant pf or Q control

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 

Time constant for Iq control response 

 

Reactive Current Injection During Voltage Dips

Parameter 

Unit

Description 

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}

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

  • 1 if the active current command has speed dependency

  • 0 for no dependency

Current Limit Logic

Parameter 

Unit

Description 

Variable = {Possible Values}

Parameter 

Unit

Description 

Variable = {Possible Values}

Imax

pu

Maximum converter current limit (P and Q combined)

 

PqFlag

 

P/Q priority flag for current limit

  • 0 for Q priority

  • 1 for P priority

Voltage-dependent Limits

image-20260317-192953.png

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

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

image-20260317-193109.png

 

Name

Unit

Description

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

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

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.