REECA1
REECB1
REECCU1
BaseClasses
Renewable Electrical Controllers
This package contains components that model the different electrical controller components of the WECC-based renewable energy sources.
| Name | Description |
|---|---|
| REECA1
|
Electrical control model for large scale wind |
| REECB1
|
Electrical control model for large scale photovoltaic |
| REECCU1
|
Electrical control model for utility scale battery energy storage |
| BaseClasses
|
Base classes for renewable energy electrical control models |
OpenIPSL.Electrical.Renewables.PSSE.ElectricalController.REECA1Electrical control model for large scale wind
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:
Extends from OpenIPSL.Electrical.Renewables.PSSE.ElectricalController.BaseClasses.BaseREECA (Base renewable energy electrical controller model A).
| Name | Description |
|---|---|
| Iqcmd | Reactice Command Current |
| Ipcmd | Real Command Current |
| Vdip | Low voltage threshold to activate reactive current injection logic (0.85 - 0.9) [1] |
| Vup | Voltage above which reactive current injection logic is activated (>1.1) [1] |
| Trv | Filter time constant for voltage measurement (0.01 - 0.02) [s] |
| dbd1 | Voltage error dead band lower threshold (-0.1 - 0) [1] |
| dbd2 | Voltage error dead band upper threshold (0 - 0.1) [1] |
| Kqv | Reactive current injection gain during over and undervoltage conditions (0 - 10) |
| Iqh1 | Upper limit on reactive current injection Iqinj (1 - 1.1) [1] |
| Iql1 | Lower limit on reactive current injection Iqinj (-1.1 - 1) [1] |
| vref0 | User defined voltage reference (0.95 - 1.05) [1] |
| Iqfrz | Value at which Iqinj is held for Thld seconds following a voltage dip if Thld > 0 [1] |
| Thld | Time for which Iqinj is held at Iqfrz after voltage dip returns to zero [s] |
| Tp | Filter time constant for electrical power (0.01 - 0.1) [s] |
| Qmax | Upper limits of the limit for reactive power regulator (0.4 - 1.0) [1] |
| Qmin | Lower limits of the limit for reactive power regulator (-1.0 - -0.4) [1] |
| Vmax | Maximum limit for voltage control (1.05 - 1.1) [1] |
| Vmin | Lower limits of input signals (0.9 - 0.95) [1] |
| Kqp | Reactive power regulator proportional gain (No predefined range) |
| Kqi | Reactive power regulator integral gain (No predefined range) |
| Kvp | Voltage regulator proportional gain (No predefined range) |
| Kvi | Voltage regulator integral gain (No predefined range) |
| Vbias | User-defined reference/bias on the inner-loop voltage control (No predefined range) [1] |
| Tiq | Time constant on lag delay (0.01 - 0.02) [s] |
| dPmax | Power reference maximum ramp rate (No predefined range) |
| dPmin | Lower limits of input signals (No predefined range) |
| Pmax | Maximum power limit [1] |
| Pmin | Minimum power limit [1] |
| Imax | Maximum limit on total converter current (1.1 - 1.3) [1] |
| Tpord | Power filter time constant (0.01 - 0.02) [s] |
| Vq1 | Reactive Power V-I pair, voltage (user defined) [1] |
| Iq1 | Reactive Power V-I pair, current (user defined) [1] |
| Vq2 | Reactive Power V-I pair, voltage (user defined) [1] |
| Iq2 | Reactive Power V-I pair, current (user defined) [1] |
| Vq3 | Reactive Power V-I pair, voltage (user defined) [1] |
| Iq3 | Reactive Power V-I pair, current (user defined) [1] |
| Vq4 | Reactive Power V-I pair, voltage (user defined) [1] |
| Iq4 | Reactive Power V-I pair, current (user defined) [1] |
| Vp1 | Real Power V-I pair, voltage (user defined) [1] |
| Ip1 | Real Power V-I pair, current (user defined) [1] |
| Vp2 | Real Power V-I pair, voltage (user defined) [1] |
| Ip2 | Real Power V-I pair, current (user defined) [1] |
| Vp3 | Real Power V-I pair, voltage (user defined) [1] |
| Ip3 | Real Power V-I pair, current (user defined) [1] |
| Vp4 | Real Power V-I pair, voltage (user defined) [1] |
| Ip4 | Real Power V-I pair, current (user defined) [1] |
| Control | |
| pfflag | Constant output value |
| vflag | Constant output value |
| qflag | Constant output value |
| pqflag | Constant output value |
| pflag | Constant output value |
| Name | Description |
|---|---|
| Vt | Terminal Voltage Magnitude |
| Pe | Active Power Generated |
| Qext | Reactive Power Reference |
| Qgen | Reactive Power Generated |
| Pref | Active Power Reference |
| ip0 | Initial Real Current |
| iq0 | Initial Imaginary Current |
| Iqcmd | Reactice Command Current |
| Ipcmd | Real Command Current |
| Wg | Rotational Speed Generator |
| v0 | Initial Terminal Voltage Magnitude |
| p0 | Initial Active Power |
| q0 | Initial Reactive Power |
OpenIPSL.Electrical.Renewables.PSSE.ElectricalController.REECB1Electrical control model for large scale photovoltaic
The REECB1 component used to represent the electrical controls of photovoltaic 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 types module.
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 REECB1 component has five inputs, three of which are connected to the inverter component (for instance REGCA1), and two more that can either be constant values from the power flow initialization or come from the connection to the plant controller. The three REECB1 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:
Extends from OpenIPSL.Electrical.Renewables.PSSE.ElectricalController.BaseClasses.BaseREECB (Base renewable energy electrical controller model B).
| Name | Description |
|---|---|
| Iqcmd | Command Reactive Current |
| Ipcmd | Command Active Current |
| Vdip | Low voltage threshold to activate reactive current injection logic (0.85 - 0.9) [1] |
| Vup | Voltage above which reactive current injection logic is activated (>1.1) [1] |
| Trv | Filter time constant for voltage measurement (0.01 - 0.02) [s] |
| dbd1 | Voltage error dead band lower threshold (-0.1 - 0) [1] |
| dbd2 | Voltage error dead band upper threshold (0 - 0.1) [1] |
| Kqv | Reactive current injection gain during over and undervoltage conditions (0 - 10) |
| Iqh1 | Upper limit on reactive current injection Iqinj (1 - 1.1) [1] |
| Iql1 | Lower limit on reactive current injection Iqinj (-1.1 - 1) [1] |
| vref0 | User defined voltage reference (0.95 - 1.05) [1] |
| Tp | Filter time constant for electrical power (0.01 - 0.1) [s] |
| Qmax | Upper limits of the limit for reactive power regulator (0.4 - 1.0) [1] |
| Qmin | Lower limits of the limit for reactive power regulator (-1.0 - -0.4) [1] |
| Vmax | Maximum limit for voltage control (1.05 - 1.1) [1] |
| Vmin | Lower limits of input signals (0.9 - 0.95) [1] |
| Kqp | Reactive power regulator proportional gain (No predefined range) |
| Kqi | Reactive power regulator integral gain (No predefined range) |
| Kvp | Voltage regulator proportional gain (No predefined range) |
| Kvi | Voltage regulator integral gain (No predefined range) |
| Tiq | Time constant on lag delay (0.01 - 0.02) [s] |
| dPmax | Power reference maximum ramp rate (No predefined range) |
| dPmin | Lower limits of input signals (No predefined range) |
| Pmax | Maximum power limit [1] |
| Pmin | Minimum power limit [1] |
| Imax | Maximum limit on total converter current (1.1 - 1.3) [1] |
| Tpord | Power filter time constant (0.01 - 0.02) [s] |
| Control | |
| pfflag | Constant output value |
| vflag | Constant output value |
| qflag | Constant output value |
| pqflag | Constant output value |
| Name | Description |
|---|---|
| Vt | Terminal Voltage Magnitude |
| Pe | Electrical Power Generation |
| Qext | Reactive Power Reference |
| Qgen | Reactive Power Generation |
| Pref | Active Power Reference |
| ip0 | Initial Real Current |
| iq0 | Initial Reactive Current |
| Iqcmd | Command Reactive Current |
| Ipcmd | Command Active Current |
| v0 | Initial Terminal Voltage Magnitude |
| p0 | Initial Active Power |
| q0 | Initial Reactive Power |
OpenIPSL.Electrical.Renewables.PSSE.ElectricalController.REECCU1Electrical control model for utility scale battery energy storage
The REECCU1 component is an augmented version of the existing renewable energy electrical control (REECA1) model, and can be utilized to represent both type 3 and type 4 wind turbine electrical controllers as well as photovoltaic electrical controllers. The REECCU1 component can be connected to the plant controller (REPCA1). This electrical controller provides real (Ipcmd) and reactive (Iqcmd) current commands to the REGCA1 component, which are the outputs of this component.
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 REECCU1 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 auxiliary input variable that is rarely used (usually constant and zero). The three REECCU1 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:
Extends from OpenIPSL.Electrical.Renewables.PSSE.ElectricalController.BaseClasses.BaseREECC (Base renewable energy electrical controller model C).
| Name | Description |
|---|---|
| Iqcmd | Reactive Command Current |
| Ipcmd | Active Command Current |
| Vdip | Low voltage threshold to activate reactive current injection logic (0.85 - 0.9) [1] |
| Vup | Voltage above which reactive current injection logic is activated (>1.1) [1] |
| Trv | Filter time constant for voltage measurement (0.01 - 0.02) [s] |
| dbd1 | Voltage error dead band lower threshold (-0.1 - 0) [1] |
| dbd2 | Voltage error dead band upper threshold (0 - 0.1) [1] |
| Kqv | Reactive current injection gain during over and undervoltage conditions (0 - 10) |
| Iqh1 | Upper limit on reactive current injection Iqinj (1 - 1.1) [1] |
| Iql1 | Lower limit on reactive current injection Iqinj (-1.1 - 1) [1] |
| vref0 | User defined voltage reference (0.95 - 1.05) [1] |
| Tp | Filter time constant for electrical power (0.01 - 0.1) [s] |
| Qmax | Upper limits of the limit for reactive power regulator (0.4 - 1.0) [1] |
| Qmin | Lower limits of the limit for reactive power regulator (-1.0 - -0.4) [1] |
| Vmax | Maximum limit for voltage control (1.05 - 1.1) [1] |
| Vmin | Lower limits of input signals (0.9 - 0.95) [1] |
| Kqp | Reactive power regulator proportional gain (No predefined range) |
| Kqi | Reactive power regulator integral gain (No predefined range) |
| Kvp | Voltage regulator proportional gain (No predefined range) |
| Kvi | Voltage regulator integral gain (No predefined range) |
| Tiq | Time constant on lag delay (0.01 - 0.02) [s] |
| dPmax | Power reference maximum ramp rate (No predefined range) |
| dPmin | Lower limits of input signals (No predefined range) |
| Pmax | Maximum power limit [1] |
| Pmin | Minimum power limit [1] |
| Imax | Maximum limit on total converter current (1.1 - 1.3) [1] |
| Tpord | Power filter time constant (0.01 - 0.02) [s] |
| Vq1 | Reactive Power V-I pair, voltage (user defined) [1] |
| Iq1 | Reactive Power V-I pair, current (user defined) [1] |
| Vq2 | Reactive Power V-I pair, voltage (user defined) [1] |
| Iq2 | Reactive Power V-I pair, current (user defined) [1] |
| Vq3 | Reactive Power V-I pair, voltage (user defined) [1] |
| Iq3 | Reactive Power V-I pair, current (user defined) [1] |
| Vq4 | Reactive Power V-I pair, voltage (user defined) [1] |
| Iq4 | Reactive Power V-I pair, current (user defined) [1] |
| Vp1 | Real Power V-I pair, voltage (user defined) [1] |
| Ip1 | Real Power V-I pair, current (user defined) [1] |
| Vp2 | Real Power V-I pair, voltage (user defined) [1] |
| Ip2 | Real Power V-I pair, current (user defined) [1] |
| Vp3 | Real Power V-I pair, voltage (user defined) [1] |
| Ip3 | Real Power V-I pair, current (user defined) [1] |
| Vp4 | Real Power V-I pair, voltage (user defined) [1] |
| Ip4 | Real Power V-I pair, current (user defined) [1] |
| T | Battery discharge time [s] |
| SOCini | Initial state of charge [1] |
| SOCmax | Maximum allowable state of charge [1] |
| SOCmin | Minimum allowable state of charge [1] |
| Control | |
| pfflag | Constant output value |
| vflag | Constant output value |
| qflag | Constant output value |
| pqflag | Constant output value |
| Name | Description |
|---|---|
| ip0 | Initial Active Current |
| iq0 | Initial Reactive Current |
| Iqcmd | Reactive Command Current |
| Ipcmd | Active Command Current |
| v0 | Initial Terminal Voltage Magnitude |
| p0 | Initial Active Power |
| q0 | Initial Reactive Power |
| Vt | Terminal Voltage Magnitude |
| Pe | Electrical Power |
| Qext | Reactive Power Reference |
| Qgen | Reactive Power Generated |
| Pref | Active Power Reference |
| Paux | Auxiliary Signal for Active Power |