.. _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:`y_{s1}` | State | Integrator output | | v_str | +-------+---------------------+------------+------------------------+--------+------------+ | s2_y | :math:`y_{s2}` | State | Integrator output | | v_str | +-------+---------------------+------------+------------------------+--------+------------+ | s3_y | :math:`y_{s3}` | State | Integrator output | | v_str | +-------+---------------------+------------+------------------------+--------+------------+ | wt | :math:`\omega_{t}` | AliasState | Alias of s1_y | | | +-------+---------------------+------------+------------------------+--------+------------+ | wg | :math:`\omega_{g}` | AliasState | Alias of s2_y | | | +-------+---------------------+------------+------------------------+--------+------------+ | wr0 | :math:`\omega_{r0}` | Algeb | speed set point | *p.u.* | v_str | +-------+---------------------+------------+------------------------+--------+------------+ | Pm | :math:`P_{m}` | Algeb | Mechanical power | | v_str | +-------+---------------------+------------+------------------------+--------+------------+ | pd | :math:`P_{d}` | 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:`y_{s1}` | State | :math:`\omega_{r0}` | +-------+---------------------+------------+------------------------------------+ | s2_y | :math:`y_{s2}` | State | :math:`\omega_{r0}` | +-------+---------------------+------------+------------------------------------+ | s3_y | :math:`y_{s3}` | State | :math:`\frac{P_{e0}}{\omega_{r0}}` | +-------+---------------------+------------+------------------------------------+ | wt | :math:`\omega_{t}` | AliasState | | +-------+---------------------+------------+------------------------------------+ | wg | :math:`\omega_{g}` | AliasState | | +-------+---------------------+------------+------------------------------------+ | wr0 | :math:`\omega_{r0}` | Algeb | :math:`\omega_{0}` | +-------+---------------------+------------+------------------------------------+ | Pm | :math:`P_{m}` | Algeb | :math:`P_{e0}` | +-------+---------------------+------------+------------------------------------+ | pd | :math:`P_{d}` | 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:`y_{s1}` | State | :math:`- 1.0 P_{d} + \frac{1.0 P_{m}}{y_{s1}} - 1.0 y_{s3}` | :math:`2H_t` | +-------+--------------------+------------+--------------------------------------------------------------------------------------------------------+--------------+ | s2_y | :math:`y_{s2}` | State | :math:`- 1.0 Damp \left(- \omega_{0} + y_{s2}\right) + 1.0 P_{d} - \frac{1.0 Pe}{y_{s2}} + 1.0 y_{s3}` | :math:`2H_g` | +-------+--------------------+------------+--------------------------------------------------------------------------------------------------------+--------------+ | s3_y | :math:`y_{s3}` | State | :math:`K_{shaft} \left(y_{s1} - y_{s2}\right)` | :math:`1.0` | +-------+--------------------+------------+--------------------------------------------------------------------------------------------------------+--------------+ | wt | :math:`\omega_{t}` | AliasState | :math:`0` | | +-------+--------------------+------------+--------------------------------------------------------------------------------------------------------+--------------+ | wg | :math:`\omega_{g}` | AliasState | :math:`0` | | +-------+--------------------+------------+--------------------------------------------------------------------------------------------------------+--------------+ Algebraic Equations ----------------------------- +------+---------------------+----------+--------------------------------------------------------+ | Name | Symbol | Type | RHS of Equation "0 = g(x, y)" | +======+=====================+==========+========================================================+ | wr0 | :math:`\omega_{r0}` | Algeb | :math:`\omega_{0} - \omega_{r0}` | +------+---------------------+----------+--------------------------------------------------------+ | Pm | :math:`P_{m}` | Algeb | :math:`- P_{m} + P_{e0}` | +------+---------------------+----------+--------------------------------------------------------+ | pd | :math:`P_{d}` | Algeb | :math:`D_{shaft} \left(y_{s1} - y_{s2}\right) - P_{d}` | +------+---------------------+----------+--------------------------------------------------------+ | wge | :math:`wge` | ExtAlgeb | :math:`y_{s2} - 1.0` | +------+---------------------+----------+--------------------------------------------------------+ | Pe | :math:`Pe` | ExtAlgeb | :math:`0` | +------+---------------------+----------+--------------------------------------------------------+ Services ---------- +---------+-------------------+------------------------------------------------------------+--------------+ | Name | Symbol | Equation | Type | +=========+===================+============================================================+==============+ | Ht2 | :math:`2H_t` | :math:`2 D_{shaft} H_{t}` | ConstService | +---------+-------------------+------------------------------------------------------------+--------------+ | Hg2 | :math:`2H_g` | :math:`2 H_{t} \left(1 - D_{shaft}\right)` | ConstService | +---------+-------------------+------------------------------------------------------------+--------------+ | Kshaft | :math:`K_{shaft}` | :math:`\frac{0.5 \cdot 2H_{g} 2H_{t} Freq_{1}^{2}}{H_{t}}` | 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:`y_{s1}` | State | Integrator output | | v_str | +-------+---------------------+------------+------------------------+--------+------------+ | s3_y | :math:`y_{s3}` | State | Unused state variable | | | +-------+---------------------+------------+------------------------+--------+------------+ | wt | :math:`\omega_{t}` | AliasState | Alias of s1_y | | | +-------+---------------------+------------+------------------------+--------+------------+ | wg | :math:`\omega_{g}` | AliasState | Alias of s1_y | | | +-------+---------------------+------------+------------------------+--------+------------+ | Pm | :math:`P_{m}` | Algeb | Mechanical power | | v_str | +-------+---------------------+------------+------------------------+--------+------------+ | wr0 | :math:`\omega_{r0}` | 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:`y_{s1}` | State | :math:`\omega_{r0}` | +-------+---------------------+------------+---------------------+ | s3_y | :math:`y_{s3}` | State | | +-------+---------------------+------------+---------------------+ | wt | :math:`\omega_{t}` | AliasState | | +-------+---------------------+------------+---------------------+ | wg | :math:`\omega_{g}` | AliasState | | +-------+---------------------+------------+---------------------+ | Pm | :math:`P_{m}` | Algeb | :math:`P_{e0}` | +-------+---------------------+------------+---------------------+ | wr0 | :math:`\omega_{r0}` | Algeb | :math:`\omega_{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:`y_{s1}` | State | :math:`- 1.0 D_{shaft} \left(- \omega_{r0} + y_{s1}\right) + \frac{1.0 \left(P_{m} - Pe\right)}{wge}` | :math:`2H` | +-------+--------------------+------------+-------------------------------------------------------------------------------------------------------+------------+ | s3_y | :math:`y_{s3}` | State | :math:`0` | | +-------+--------------------+------------+-------------------------------------------------------------------------------------------------------+------------+ | wt | :math:`\omega_{t}` | AliasState | :math:`0` | | +-------+--------------------+------------+-------------------------------------------------------------------------------------------------------+------------+ | wg | :math:`\omega_{g}` | AliasState | :math:`0` | | +-------+--------------------+------------+-------------------------------------------------------------------------------------------------------+------------+ Algebraic Equations ----------------------------- +------+---------------------+----------+----------------------------------+ | Name | Symbol | Type | RHS of Equation "0 = g(x, y)" | +======+=====================+==========+==================================+ | Pm | :math:`P_{m}` | Algeb | :math:`- P_{m} + P_{e0}` | +------+---------------------+----------+----------------------------------+ | wr0 | :math:`\omega_{r0}` | Algeb | :math:`\omega_{0} - \omega_{r0}` | +------+---------------------+----------+----------------------------------+ | wge | :math:`wge` | ExtAlgeb | :math:`y_{s1} - 1.0` | +------+---------------------+----------+----------------------------------+ | Pe | :math:`Pe` | ExtAlgeb | :math:`0` | +------+---------------------+----------+----------------------------------+ Services ---------- +---------+-------------------+-----------------+--------------+ | Name | Symbol | Equation | Type | +=========+===================+=================+==============+ | H2 | :math:`2H` | :math:`2 H_{t}` | 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) | +---------------+--------+-------+---------------------------------------+-----------------+