.. _RenGovernor: ================================================================================ RenGovernor ================================================================================ Renewable turbine governor group. Common Parameters: u, name, ree, w0, Sn, Pe0 Common Variables: Pm, wr0, wt, wg, s3_y Available models: WTDTA1_, WTDS_ .. _WTDTA1: -------------------------------------------------------------------------------- WTDTA1 -------------------------------------------------------------------------------- WTDTA wind turbine drive-train model. One can set ``Htfrac`` to ``0`` to simulate a single-mass drive train. ``Htfrac`` has to be within ``[0, 1]`` User-provided reference speed should be specified in parameter `w0`. Internally, `w0` is set to the algebraic variable `wr0`. Note for PSS/E dyr parser: In PSS/E doc, `Freq1` is said to be Hz, but exported data from PSS/E 34 uses per unit. ANDES requires ``Freq1`` in per unit frequency. Parameters ---------- +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ | Name | Symbol | Description | Default | Unit | Properties | +=========+===================+=====================================================+=========+===================+=============================+ | idx | | unique device idx | | | | +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ | u | :math:`u` | connection status | 1 | *bool* | | +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ | name | | device name | | | | +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ | ree | | Renewable exciter idx | | | mandatory | +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ | H | :math:`H_t` | Total inertia constant | 3 | *MWs/MVA* | non_zero,non_negative,power | +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ | DAMP | :math:`Damp` | Damp coefficient | 0 | *p.u. (gen base)* | power | +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ | Htfrac | :math:`D_{shaft}` | Turbine inertia fraction (Hturb/H) | 0.500 | | power | +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ | Freq1 | :math:`Freq1` | First shaft torsional resonant frequency, p.u. (Hz) | 1 | *p.u. (Hz)* | | +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ | Dshaft | :math:`D_{shaft}` | Shaft damping factor | 1 | *p.u. (gen base)* | power | +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ | w0 | :math:`\omega_0` | Default speed if not using a torque model | 1 | *p.u.* | | +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ | reg | | | 0 | | | +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ | Sn | :math:`S_n` | | 0 | | | +---------+-------------------+-----------------------------------------------------+---------+-------------------+-----------------------------+ Variables --------- +-------+-----------------+------------+------------------------+--------+------------+ | Name | Symbol | Type | Description | Unit | Properties | +=======+=================+============+========================+========+============+ | s1_y | :math:`s_{1 y}` | State | Integrator output | | v_str | +-------+-----------------+------------+------------------------+--------+------------+ | s2_y | :math:`s_{2 y}` | State | Integrator output | | v_str | +-------+-----------------+------------+------------------------+--------+------------+ | s3_y | :math:`s_{3 y}` | State | Integrator output | | v_str | +-------+-----------------+------------+------------------------+--------+------------+ | wt | :math:`wt` | AliasState | Alias of s1_y | | | +-------+-----------------+------------+------------------------+--------+------------+ | wg | :math:`wg` | AliasState | Alias of s2_y | | | +-------+-----------------+------------+------------------------+--------+------------+ | wr0 | :math:`wr_{0}` | Algeb | speed set point | *p.u.* | v_str | +-------+-----------------+------------+------------------------+--------+------------+ | Pm | :math:`Pm` | Algeb | Mechanical power | | v_str | +-------+-----------------+------------+------------------------+--------+------------+ | pd | :math:`pd` | Algeb | Output after damping | | v_str | +-------+-----------------+------------+------------------------+--------+------------+ | wge | :math:`wge` | ExtAlgeb | | | | +-------+-----------------+------------+------------------------+--------+------------+ | Pe | :math:`Pe` | ExtAlgeb | Retrieved Pe of RenGen | | | +-------+-----------------+------------+------------------------+--------+------------+ Initialization Equations ------------------------ +-------+-----------------+------------+-------------------------------+ | Name | Symbol | Type | Initial Value | +=======+=================+============+===============================+ | s1_y | :math:`s_{1 y}` | State | :math:`wr_{0}` | +-------+-----------------+------------+-------------------------------+ | s2_y | :math:`s_{2 y}` | State | :math:`wr_{0}` | +-------+-----------------+------------+-------------------------------+ | s3_y | :math:`s_{3 y}` | State | :math:`\frac{Pe_{0}}{wr_{0}}` | +-------+-----------------+------------+-------------------------------+ | wt | :math:`wt` | AliasState | | +-------+-----------------+------------+-------------------------------+ | wg | :math:`wg` | AliasState | | +-------+-----------------+------------+-------------------------------+ | wr0 | :math:`wr_{0}` | Algeb | :math:`w_{0}` | +-------+-----------------+------------+-------------------------------+ | Pm | :math:`Pm` | Algeb | :math:`Pe_{0}` | +-------+-----------------+------------+-------------------------------+ | pd | :math:`pd` | Algeb | :math:`0` | +-------+-----------------+------------+-------------------------------+ | wge | :math:`wge` | ExtAlgeb | | +-------+-----------------+------------+-------------------------------+ | Pe | :math:`Pe` | ExtAlgeb | | +-------+-----------------+------------+-------------------------------+ Differential Equations ----------------------------- +-------+-----------------+------------+-------------------------------------------------------------------------------------------------+--------------+ | Name | Symbol | Type | RHS of Equation "T x' = f(x, y)" | T (LHS) | +=======+=================+============+=================================================================================================+==============+ | s1_y | :math:`s_{1 y}` | State | :math:`\frac{1.0 Pm}{s_{1 y}} - 1.0 pd - 1.0 s_{3 y}` | :math:`2H_t` | +-------+-----------------+------------+-------------------------------------------------------------------------------------------------+--------------+ | s2_y | :math:`s_{2 y}` | State | :math:`- 1.0 DAMP \left(s_{2 y} - w_{0}\right) - \frac{1.0 Pe}{s_{2 y}} + 1.0 pd + 1.0 s_{3 y}` | :math:`2H_g` | +-------+-----------------+------------+-------------------------------------------------------------------------------------------------+--------------+ | s3_y | :math:`s_{3 y}` | State | :math:`Kshaft \left(s_{1 y} - s_{2 y}\right)` | :math:`1.0` | +-------+-----------------+------------+-------------------------------------------------------------------------------------------------+--------------+ | wt | :math:`wt` | AliasState | :math:`0` | | +-------+-----------------+------------+-------------------------------------------------------------------------------------------------+--------------+ | wg | :math:`wg` | AliasState | :math:`0` | | +-------+-----------------+------------+-------------------------------------------------------------------------------------------------+--------------+ Algebraic Equations ----------------------------- +------+----------------+----------+----------------------------------------------------+ | Name | Symbol | Type | RHS of Equation "0 = g(x, y)" | +======+================+==========+====================================================+ | wr0 | :math:`wr_{0}` | Algeb | :math:`w_{0} - wr_{0}` | +------+----------------+----------+----------------------------------------------------+ | Pm | :math:`Pm` | Algeb | :math:`Pe_{0} - Pm` | +------+----------------+----------+----------------------------------------------------+ | pd | :math:`pd` | Algeb | :math:`Dshaft \left(s_{1 y} - s_{2 y}\right) - pd` | +------+----------------+----------+----------------------------------------------------+ | wge | :math:`wge` | ExtAlgeb | :math:`s_{2 y} - 1.0` | +------+----------------+----------+----------------------------------------------------+ | Pe | :math:`Pe` | ExtAlgeb | :math:`0` | +------+----------------+----------+----------------------------------------------------+ Services ---------- +---------+-------------------+--------------------------------------------------+--------------+ | Name | Symbol | Equation | Type | +=========+===================+==================================================+==============+ | Ht2 | :math:`2H_t` | :math:`2 H Htfrac` | ConstService | +---------+-------------------+--------------------------------------------------+--------------+ | Hg2 | :math:`2H_g` | :math:`2 H \left(1 - Htfrac\right)` | ConstService | +---------+-------------------+--------------------------------------------------+--------------+ | Kshaft | :math:`K_{shaft}` | :math:`\frac{0.5 Freq_{1}^{2} Hg_{2} Ht_{2}}{H}` | ConstService | +---------+-------------------+--------------------------------------------------+--------------+ Blocks ------- +------+------------+------------+------+ | Name | Symbol | Type | Info | +======+============+============+======+ | s1 | :math:`s1` | Integrator | | +------+------------+------------+------+ | s2 | :math:`s2` | Integrator | | +------+------------+------------+------+ | s3 | :math:`s3` | Integrator | | +------+------------+------------+------+ Config Fields in [WTDTA1] +---------------+--------+-------+---------------------------------------+-----------------+ | 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) | +---------------+--------+-------+---------------------------------------+-----------------+ .. _WTDS: -------------------------------------------------------------------------------- WTDS -------------------------------------------------------------------------------- Custom wind turbine model with a single swing-equation. This model is used to simulate the mechanical swing of the combined machine and turbine mass. The speed output is ``s1_y`` which will be fed to ``RenExciter.wg``. ``PFLAG`` needs to be set to ``1`` in exciter to consider speed for Pref. Parameters ---------- +-------+-------------------+-------------------------------------------+---------+-----------+-----------------------------+ | Name | Symbol | Description | Default | Unit | Properties | +=======+===================+===========================================+=========+===========+=============================+ | idx | | unique device idx | | | | +-------+-------------------+-------------------------------------------+---------+-----------+-----------------------------+ | u | :math:`u` | connection status | 1 | *bool* | | +-------+-------------------+-------------------------------------------+---------+-----------+-----------------------------+ | name | | device name | | | | +-------+-------------------+-------------------------------------------+---------+-----------+-----------------------------+ | ree | | Renewable exciter idx | | | mandatory | +-------+-------------------+-------------------------------------------+---------+-----------+-----------------------------+ | H | :math:`H_t` | Total inertia | 3 | *MWs/MVA* | non_zero,non_negative,power | +-------+-------------------+-------------------------------------------+---------+-----------+-----------------------------+ | D | :math:`D_{shaft}` | Damping coefficient | 1 | *p.u.* | power | +-------+-------------------+-------------------------------------------+---------+-----------+-----------------------------+ | w0 | :math:`\omega_0` | Default speed if not using a torque model | 1 | *p.u.* | | +-------+-------------------+-------------------------------------------+---------+-----------+-----------------------------+ | reg | | | 0 | | | +-------+-------------------+-------------------------------------------+---------+-----------+-----------------------------+ | Sn | :math:`S_n` | | 0 | | | +-------+-------------------+-------------------------------------------+---------+-----------+-----------------------------+ Variables --------- +-------+-----------------+------------+------------------------+--------+------------+ | Name | Symbol | Type | Description | Unit | Properties | +=======+=================+============+========================+========+============+ | s1_y | :math:`s_{1 y}` | State | Integrator output | | v_str | +-------+-----------------+------------+------------------------+--------+------------+ | s3_y | :math:`s_{3 y}` | State | Unused state variable | | | +-------+-----------------+------------+------------------------+--------+------------+ | wt | :math:`wt` | AliasState | Alias of s1_y | | | +-------+-----------------+------------+------------------------+--------+------------+ | wg | :math:`wg` | AliasState | Alias of s1_y | | | +-------+-----------------+------------+------------------------+--------+------------+ | Pm | :math:`Pm` | Algeb | Mechanical power | | v_str | +-------+-----------------+------------+------------------------+--------+------------+ | wr0 | :math:`wr_{0}` | Algeb | speed set point | *p.u.* | v_str | +-------+-----------------+------------+------------------------+--------+------------+ | wge | :math:`wge` | ExtAlgeb | | | | +-------+-----------------+------------+------------------------+--------+------------+ | Pe | :math:`Pe` | ExtAlgeb | Retrieved Pe of RenGen | | | +-------+-----------------+------------+------------------------+--------+------------+ Initialization Equations ------------------------ +-------+-----------------+------------+----------------+ | Name | Symbol | Type | Initial Value | +=======+=================+============+================+ | s1_y | :math:`s_{1 y}` | State | :math:`wr_{0}` | +-------+-----------------+------------+----------------+ | s3_y | :math:`s_{3 y}` | State | | +-------+-----------------+------------+----------------+ | wt | :math:`wt` | AliasState | | +-------+-----------------+------------+----------------+ | wg | :math:`wg` | AliasState | | +-------+-----------------+------------+----------------+ | Pm | :math:`Pm` | Algeb | :math:`Pe_{0}` | +-------+-----------------+------------+----------------+ | wr0 | :math:`wr_{0}` | Algeb | :math:`w_{0}` | +-------+-----------------+------------+----------------+ | wge | :math:`wge` | ExtAlgeb | | +-------+-----------------+------------+----------------+ | Pe | :math:`Pe` | ExtAlgeb | | +-------+-----------------+------------+----------------+ 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 D \left(s_{1 y} - wr_{0}\right) + \frac{1.0 \left(- Pe + Pm\right)}{wge}` | :math:`2H` | +-------+-----------------+------------+----------------------------------------------------------------------------------------+------------+ | s3_y | :math:`s_{3 y}` | State | :math:`0` | | +-------+-----------------+------------+----------------------------------------------------------------------------------------+------------+ | wt | :math:`wt` | AliasState | :math:`0` | | +-------+-----------------+------------+----------------------------------------------------------------------------------------+------------+ | wg | :math:`wg` | AliasState | :math:`0` | | +-------+-----------------+------------+----------------------------------------------------------------------------------------+------------+ Algebraic Equations ----------------------------- +------+----------------+----------+-------------------------------+ | Name | Symbol | Type | RHS of Equation "0 = g(x, y)" | +======+================+==========+===============================+ | Pm | :math:`Pm` | Algeb | :math:`Pe_{0} - Pm` | +------+----------------+----------+-------------------------------+ | wr0 | :math:`wr_{0}` | Algeb | :math:`w_{0} - wr_{0}` | +------+----------------+----------+-------------------------------+ | wge | :math:`wge` | ExtAlgeb | :math:`s_{1 y} - 1.0` | +------+----------------+----------+-------------------------------+ | Pe | :math:`Pe` | ExtAlgeb | :math:`0` | +------+----------------+----------+-------------------------------+ Services ---------- +---------+-------------------+-------------+--------------+ | Name | Symbol | Equation | Type | +=========+===================+=============+==============+ | H2 | :math:`2H` | :math:`2 H` | ConstService | +---------+-------------------+-------------+--------------+ | Kshaft | :math:`K_{shaft}` | :math:`1.0` | ConstService | +---------+-------------------+-------------+--------------+ Blocks ------- +------+------------+------------+------+ | Name | Symbol | Type | Info | +======+============+============+======+ | s1 | :math:`s1` | Integrator | | +------+------------+------------+------+ Config Fields in [WTDS] +---------------+--------+-------+---------------------------------------+-----------------+ | 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) | +---------------+--------+-------+---------------------------------------+-----------------+