modelREGCA1

Renewable energy generator/converter model A

Extends from BaseClasses.BaseREGC (Base renewable generator/converter for PSSE models).

Information

The REGCA1 component is used to represent the renewable source (inverter) interface with the grid. It takes in as input the real current command (Ipcmd) and the reactive current command (Iqcmd) from the electrical controller, and outputs real (Ip) and reactive (Iq) injected currents to the grid through OpenIPSL's proprietary pwpin connector.

In order to properly initialize all the components that form the renewable energy source, the REGC_A component has five initialization outputs, which its constant output originates from the starting power flow: 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). This method reduces repetitiveness of initialization calculation, being calculated once at the REGCA1 component.

The connection with other components requires a closed loop through terminal voltage variable (V_t), and active and reactive power generation (Pgen and Qgen).

The modelling of such devices is based, mainly, on the following reference:

Parameters

TypeNameDefaultDescription
Power flow data
OpenIPSL.Types.ApparentPowerM_b (from BaseREGC)SysData.S_bMachine base power
Types.ApparentPowerS_b (from pfComponent)SysData.S_bSystem base power
Types.VoltageV_b (from pfComponent)400e3Base voltage of the bus
Types.Frequencyfn (from pfComponent)SysData.fnSystem frequency
Types.ActivePowerP_0 (from pfComponent)1e6Initial active power
Types.ReactivePowerQ_0 (from pfComponent)0Initial reactive power
Types.PerUnitv_0 (from pfComponent)1Initial voltage magnitude
Types.Angleangle_0 (from pfComponent)0Initial voltage angle
BooleandisplayPF (from pfComponent)falseDisplay power flow:
Parameter mask
BooleanenableS_b (from pfComponent)falseEnable S_b in parameter list
BooleanenableV_b (from pfComponent)falseEnable V_b in parameter list
Booleanenablefn (from pfComponent)falseEnable fn in parameter list
BooleanenableP_0 (from pfComponent)falseEnable P_0 in parameter list
BooleanenableQ_0 (from pfComponent)falseEnable Q_0 in parameter list
Booleanenablev_0 (from pfComponent)falseEnable v_0 in parameter list
Booleanenableangle_0 (from pfComponent)falseEnable angle_0 in parameter list
BooleanenabledisplayPF (from pfComponent)falseEnable displayPF in parameter list
Input Parameters
Modelica.Units.SI.TimeTg (from BaseREGC)0.02Converter time constant
Modelica.Units.SI.TimeAgingrrpwr (from BaseREGC)10Low Voltage Power Logic (LVPL) ramp rate limit
OpenIPSL.Types.PerUnitBrkpt (from BaseREGC)0.9LVPL characteristic voltage 2
OpenIPSL.Types.PerUnitZerox (from BaseREGC)0.5LVPL characteristic voltage 1
OpenIPSL.Types.PerUnitLvpl1 (from BaseREGC)1.22LVPL gain
OpenIPSL.Types.PerUnitVolim (from BaseREGC)1.2Voltage limit for high voltage reactive current management
OpenIPSL.Types.PerUnitlvpnt1 (from BaseREGC)0.8High voltage point for low voltage active current management
OpenIPSL.Types.PerUnitlvpnt0 (from BaseREGC)0.4Low voltage point for low voltage active current management
OpenIPSL.Types.PerUnitIolim (from BaseREGC)-1.3Current limit for high voltage reactive current management (specified as a negative value)
Modelica.Units.SI.TimeTfltr (from BaseREGC)0.02Voltage filter time constant for low voltage active current management
RealKhv (from BaseREGC)0.7Overvoltage compensation gain used in the high voltage reactive current management
Modelica.Units.SI.TimeAgingIqrmax (from BaseREGC)9999Upper limit on rate of change for reactive current
Modelica.Units.SI.TimeAgingIqrmin (from BaseREGC)-9999Lower limit on rate of change for reactive current
Controls
BooleanLvplsw (from BaseREGC)trueEnable (true) or disable (false) low voltage power logic.

Connectors

TypeNameDefaultDescription
OpenIPSL.Interfaces.PwPinp (from BaseREGC)
Modelica.Blocks.Interfaces.RealInputIqcmd (from BaseREGC)Imaginary Command Current
Modelica.Blocks.Interfaces.RealInputIpcmd (from BaseREGC)Real Command Current
Modelica.Blocks.Interfaces.RealOutputIQ0 (from BaseREGC)Initial Reactive Power
Modelica.Blocks.Interfaces.RealOutputIP0 (from BaseREGC)Initial Active Power
Modelica.Blocks.Interfaces.RealOutputV_0 (from BaseREGC)Initial Terminal Voltage Magnitude
Modelica.Blocks.Interfaces.RealOutputq_0 (from BaseREGC)Initial Reactive Power
Modelica.Blocks.Interfaces.RealOutputp_0 (from BaseREGC)Initial Active Power
Modelica.Blocks.Interfaces.RealOutputV_t (from BaseREGC)Terminal Voltage Magnitude
Modelica.Blocks.Interfaces.RealOutputPgen (from BaseREGC)Active Power injection
Modelica.Blocks.Interfaces.RealOutputQgen (from BaseREGC)Reactive Power injection

Components

TypeNameDefaultDescription
OpenIPSL.Electrical.SystemBaseSysData (from pfComponent)Must add this line in all models
Modelica.Blocks.Sources.RealExpressionVt
Modelica.Blocks.Math.Addadd
Modelica.Blocks.Sources.ConstantVo_limit
Modelica.Blocks.Nonlinear.Limitermin_limiter
Modelica.Blocks.Math.Addadd1
Modelica.Blocks.Nonlinear.LimiterIOLIM
OpenIPSL.Electrical.Renewables.PSSE.InverterInterface.BaseClasses.LVACMLVACM
OpenIPSL.NonElectrical.Continuous.SimpleLagsimpleLag
OpenIPSL.Electrical.Renewables.PSSE.InverterInterface.BaseClasses.LVPLLVPL
Modelica.Blocks.Math.ProductIP
Modelica.Blocks.Math.GainKHV
Modelica.Blocks.Logical.Switchswitch1
Modelica.Blocks.Sources.BooleanConstantLvplsw_logic
Modelica.Blocks.Nonlinear.Limiterlimiter4
Modelica.Blocks.Math.Addadd2
Modelica.Blocks.Sources.RealExpressionTerminal_Voltage1
Modelica.Blocks.Sources.RealExpressionLowerLimit
Modelica.Blocks.Math.Addadd3
Modelica.Blocks.Nonlinear.Limiterlimiter1
Modelica.Blocks.Continuous.Integratorintegrator
Modelica.Blocks.Math.Gaingain
Modelica.Blocks.Sources.RealExpressionConstant
Modelica.Blocks.Continuous.Integratorintegrator1
Modelica.Blocks.Nonlinear.VariableLimitervariableLimiter