.. _RenTorque: ================================================================================ RenTorque ================================================================================ Renewable torque (Pref) controller. Common Parameters: u, name Available models: WTTQA1_ .. _WTTQA1: -------------------------------------------------------------------------------- WTTQA1 -------------------------------------------------------------------------------- Wind turbine generator torque (Pref) model. PI state freeze following voltage dip has not been implemented. Resets `wg` in `REECA1` model to 1.0 when torque model is connected. This effectively ignores `PFLAG` of `REECA1`. Parameters ---------- +--------+------------------+------------------------------------------+---------+--------+------------+ | Name | Symbol | Description | Default | Unit | Properties | +========+==================+==========================================+=========+========+============+ | idx | | unique device idx | | | | +--------+------------------+------------------------------------------+---------+--------+------------+ | u | :math:`u` | connection status | 1 | *bool* | | +--------+------------------+------------------------------------------+---------+--------+------------+ | name | | device name | | | | +--------+------------------+------------------------------------------+---------+--------+------------+ | rep | | RenPitch controller idx | | | mandatory | +--------+------------------+------------------------------------------+---------+--------+------------+ | Kip | :math:`K_{ip}` | Pref-control integral gain | 0.100 | *p.u.* | | +--------+------------------+------------------------------------------+---------+--------+------------+ | Kpp | :math:`K_{pp}` | Pref-control proportional gain | 0 | *p.u.* | | +--------+------------------+------------------------------------------+---------+--------+------------+ | Tp | :math:`T_p` | Pe sensing time const. | 0.050 | *s* | | +--------+------------------+------------------------------------------+---------+--------+------------+ | Twref | :math:`T_{wref}` | Speed reference time const. | 30 | *s* | | +--------+------------------+------------------------------------------+---------+--------+------------+ | Temax | :math:`T_{emax}` | Max. electric torque | 1.200 | *p.u.* | power | +--------+------------------+------------------------------------------+---------+--------+------------+ | Temin | :math:`T_{emin}` | Min. electric torque | 0 | *p.u.* | power | +--------+------------------+------------------------------------------+---------+--------+------------+ | Tflag | | Tflag; 1-power error, 0-speed error | | *bool* | mandatory | +--------+------------------+------------------------------------------+---------+--------+------------+ | p1 | :math:`p_1` | Active power point 1 | 0.200 | *p.u.* | power | +--------+------------------+------------------------------------------+---------+--------+------------+ | sp1 | :math:`s_{p1}` | Speed power point 1 | 0.580 | *p.u.* | | +--------+------------------+------------------------------------------+---------+--------+------------+ | p2 | :math:`p_2` | Active power point 2 | 0.400 | *p.u.* | power | +--------+------------------+------------------------------------------+---------+--------+------------+ | sp2 | :math:`s_{p2}` | Speed power point 2 | 0.720 | *p.u.* | | +--------+------------------+------------------------------------------+---------+--------+------------+ | p3 | :math:`p_3` | Active power point 3 | 0.600 | *p.u.* | power | +--------+------------------+------------------------------------------+---------+--------+------------+ | sp3 | :math:`s_{p3}` | Speed power point 3 | 0.860 | *p.u.* | | +--------+------------------+------------------------------------------+---------+--------+------------+ | p4 | :math:`p_4` | Active power point 4 | 0.800 | *p.u.* | power | +--------+------------------+------------------------------------------+---------+--------+------------+ | sp4 | :math:`s_{p4}` | Speed power point 4 | 1 | *p.u.* | | +--------+------------------+------------------------------------------+---------+--------+------------+ | Tn | :math:`T_n` | Turbine rating. Use Sn from gov if none. | nan | *MVA* | | +--------+------------------+------------------------------------------+---------+--------+------------+ | rea | | | 0 | | | +--------+------------------+------------------------------------------+---------+--------+------------+ | rego | | | 0 | | | +--------+------------------+------------------------------------------+---------+--------+------------+ | ree | | | 0 | | | +--------+------------------+------------------------------------------+---------+--------+------------+ | reg | | | 0 | | | +--------+------------------+------------------------------------------+---------+--------+------------+ | Sngo | :math:`S_{n,go}` | | 0 | | | +--------+------------------+------------------------------------------+---------+--------+------------+ | w0 | :math:`\omega_0` | | 0 | | | +--------+------------------+------------------------------------------+---------+--------+------------+ Variables --------- +---------+-------------------+----------+---------------------------------------+------+----------------+ | Name | Symbol | Type | Description | Unit | Properties | +=========+===================+==========+=======================================+======+================+ | s1_y | :math:`s_{1 y}` | State | State in lag transfer function | | v_str | +---------+-------------------+----------+---------------------------------------+------+----------------+ | s2_y | :math:`s_{2 y}` | State | State in lag transfer function | | v_str | +---------+-------------------+----------+---------------------------------------+------+----------------+ | PI_xi | :math:`\pi_{\xi}` | State | Integrator output | | v_str | +---------+-------------------+----------+---------------------------------------+------+----------------+ | wg | :math:`wg` | ExtState | | | v_str,v_setter | +---------+-------------------+----------+---------------------------------------+------+----------------+ | wt | :math:`wt` | ExtState | | | v_str,v_setter | +---------+-------------------+----------+---------------------------------------+------+----------------+ | s3_y | :math:`s_{3 y}` | ExtState | | | v_str,v_setter | +---------+-------------------+----------+---------------------------------------+------+----------------+ | fPe_y | :math:`fPe_{y}` | Algeb | Output of piecewise | | v_str | +---------+-------------------+----------+---------------------------------------+------+----------------+ | Tsel | :math:`Tsel` | Algeb | Output after Tflag selector | | v_str | +---------+-------------------+----------+---------------------------------------+------+----------------+ | PI_yul | :math:`\pi_{yul}` | Algeb | | | v_str | +---------+-------------------+----------+---------------------------------------+------+----------------+ | PI_y | :math:`\pi_{y}` | Algeb | PI output | | v_str | +---------+-------------------+----------+---------------------------------------+------+----------------+ | Pe | :math:`Pe` | ExtAlgeb | | | | +---------+-------------------+----------+---------------------------------------+------+----------------+ | wr0 | :math:`wr_{0}` | ExtAlgeb | Retrieved initial w0 from RenGovernor | | v_str,v_setter | +---------+-------------------+----------+---------------------------------------+------+----------------+ | wge | :math:`wge` | ExtAlgeb | | | v_str,v_setter | +---------+-------------------+----------+---------------------------------------+------+----------------+ | Pref | :math:`Pref` | ExtAlgeb | | | v_str,v_setter | +---------+-------------------+----------+---------------------------------------+------+----------------+ Initialization Equations ------------------------ +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Name | Symbol | Type | Initial Value | +=========+===================+==========+=================================================================================================================================================================================================================================================================================================================================================================================================+ | s1_y | :math:`s_{1 y}` | State | :math:`1.0 Pe` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | s2_y | :math:`s_{2 y}` | State | :math:`1.0 fPe_{y}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | PI_xi | :math:`\pi_{\xi}` | State | :math:`\frac{Pref_{0}}{fPe_{y}}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | wg | :math:`wg` | ExtState | :math:`fPe_{y}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | wt | :math:`wt` | ExtState | :math:`fPe_{y}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | s3_y | :math:`s_{3 y}` | ExtState | :math:`\frac{Pref_{0}}{wg}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | fPe_y | :math:`fPe_{y}` | Algeb | :math:`\operatorname{FixPiecewise}{\left(\left( sp_{1}, \ p_{1} \geq s_{1 y}\right),\left( kp_{1} \left(- p_{1} + s_{1 y}\right) + sp_{1}, \ p_{2} \geq s_{1 y}\right),\left( kp_{2} \left(- p_{2} + s_{1 y}\right) + sp_{2}, \ p_{3} \geq s_{1 y}\right),\left( kp_{3} \left(- p_{3} + s_{1 y}\right) + sp_{3}, \ p_{4} \geq s_{1 y}\right),\left( sp_{4}, \ \text{True}\right) \right)}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Tsel | :math:`Tsel` | Algeb | :math:`SWT_{s0} \left(s_{2 y} - wg\right) + \frac{SWT_{s1} \left(Pe - Pref_{0}\right)}{wg}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | PI_yul | :math:`\pi_{yul}` | Algeb | :math:`Kpp Tsel + \frac{Pref_{0}}{fPe_{y}}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | PI_y | :math:`\pi_{y}` | Algeb | :math:`\pi_{hl zi} \pi_{yul} + \pi_{hl zl} Temin + \pi_{hl zu} Temax` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Pe | :math:`Pe` | ExtAlgeb | | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | wr0 | :math:`wr_{0}` | ExtAlgeb | :math:`fPe_{y}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | wge | :math:`wge` | ExtAlgeb | :math:`1.0` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Pref | :math:`Pref` | ExtAlgeb | :math:`\pi_{y} wg` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ Differential Equations ----------------------------- +--------+-------------------+----------+----------------------------------+------------------+ | Name | Symbol | Type | RHS of Equation "T x' = f(x, y)" | T (LHS) | +========+===================+==========+==================================+==================+ | s1_y | :math:`s_{1 y}` | State | :math:`1.0 Pe - s_{1 y}` | :math:`T_p` | +--------+-------------------+----------+----------------------------------+------------------+ | s2_y | :math:`s_{2 y}` | State | :math:`1.0 fPe_{y} - s_{2 y}` | :math:`T_{wref}` | +--------+-------------------+----------+----------------------------------+------------------+ | PI_xi | :math:`\pi_{\xi}` | State | :math:`Kip Tsel` | | +--------+-------------------+----------+----------------------------------+------------------+ | wg | :math:`wg` | ExtState | :math:`0` | | +--------+-------------------+----------+----------------------------------+------------------+ | wt | :math:`wt` | ExtState | :math:`0` | | +--------+-------------------+----------+----------------------------------+------------------+ | s3_y | :math:`s_{3 y}` | ExtState | :math:`0` | | +--------+-------------------+----------+----------------------------------+------------------+ Algebraic Equations ----------------------------- +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Name | Symbol | Type | RHS of Equation "0 = g(x, y)" | +=========+===================+==========+=============================================================================================================================================================================================================================================================================================================================================================================================================+ | fPe_y | :math:`fPe_{y}` | Algeb | :math:`- fPe_{y} + \operatorname{FixPiecewise}{\left(\left( sp_{1}, \ p_{1} \geq s_{1 y}\right),\left( kp_{1} \left(- p_{1} + s_{1 y}\right) + sp_{1}, \ p_{2} \geq s_{1 y}\right),\left( kp_{2} \left(- p_{2} + s_{1 y}\right) + sp_{2}, \ p_{3} \geq s_{1 y}\right),\left( kp_{3} \left(- p_{3} + s_{1 y}\right) + sp_{3}, \ p_{4} \geq s_{1 y}\right),\left( sp_{4}, \ \text{True}\right) \right)}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Tsel | :math:`Tsel` | Algeb | :math:`SWT_{s0} \left(s_{2 y} - wg\right) + \frac{SWT_{s1} \left(Pe - Pref_{0}\right)}{wg} - Tsel` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | PI_yul | :math:`\pi_{yul}` | Algeb | :math:`Kpp Tsel + \pi_{\xi} - \pi_{yul}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | PI_y | :math:`\pi_{y}` | Algeb | :math:`\pi_{hl zi} \pi_{yul} + \pi_{hl zl} Temin + \pi_{hl zu} Temax - \pi_{y}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Pe | :math:`Pe` | ExtAlgeb | :math:`0` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | wr0 | :math:`wr_{0}` | ExtAlgeb | :math:`fPe_{y} - w_{0}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | wge | :math:`wge` | ExtAlgeb | :math:`1 - fPe_{y}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Pref | :math:`Pref` | ExtAlgeb | :math:`\pi_{y} wg - \frac{Pref_{0}}{wge}` | +---------+-------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ Services ---------- +------+----------------+---------------------------------------------------+--------------+ | Name | Symbol | Equation | Type | +======+================+===================================================+==============+ | kp1 | :math:`k_{p1}` | :math:`\frac{- sp_{1} + sp_{2}}{- p_{1} + p_{2}}` | ConstService | +------+----------------+---------------------------------------------------+--------------+ | kp2 | :math:`k_{p2}` | :math:`\frac{- sp_{2} + sp_{3}}{- p_{2} + p_{3}}` | ConstService | +------+----------------+---------------------------------------------------+--------------+ | kp3 | :math:`k_{p3}` | :math:`\frac{- sp_{3} + sp_{4}}{- p_{3} + p_{4}}` | ConstService | +------+----------------+---------------------------------------------------+--------------+ Discretes ----------- +--------+-----------------+-------------+------+ | Name | Symbol | Type | Info | +========+=================+=============+======+ | SWT | :math:`SW_{T}` | Switcher | | +--------+-----------------+-------------+------+ | PI_aw | :math:`aw_{PI}` | AntiWindup | | +--------+-----------------+-------------+------+ | PI_hl | :math:`hl_{PI}` | HardLimiter | | +--------+-----------------+-------------+------+ Blocks ------- +------+----------------+---------------+------------------------------+ | Name | Symbol | Type | Info | +======+================+===============+==============================+ | s1 | :math:`s_1` | Lag | Pe filter | +------+----------------+---------------+------------------------------+ | fPe | :math:`f_{Pe}` | Piecewise | Piecewise Pe to wref mapping | +------+----------------+---------------+------------------------------+ | s2 | :math:`s_2` | Lag | speed filter | +------+----------------+---------------+------------------------------+ | PI | :math:`PI` | PIAWHardLimit | PI controller | +------+----------------+---------------+------------------------------+ Config Fields in [WTTQA1] +---------------+--------+-------+---------------------------------------+-----------------+ | Option | Symbol | Value | Info | Accepted values | +===============+========+=======+=======================================+=================+ | allow_adjust | | 1 | allow adjusting upper or lower limits | (0, 1) | +---------------+--------+-------+---------------------------------------+-----------------+ | adjust_lower | | 0 | adjust lower limit | (0, 1) | +---------------+--------+-------+---------------------------------------+-----------------+ | adjust_upper | | 1 | adjust upper limit | (0, 1) | +---------------+--------+-------+---------------------------------------+-----------------+