.. _RenAerodynamics:

================================================================================
RenAerodynamics
================================================================================
Renewable aerodynamics group.

Common Parameters: u, name, rego

Common Variables: theta

Available models:
WTARA1_,
WTARV1_

.. _WTARA1:

--------------------------------------------------------------------------------
WTARA1
--------------------------------------------------------------------------------
Wind turbine aerodynamics model (no wind speed details).

Parameters
----------

+---------+------------------+------------------------+---------+-------------+--------------+
|  Name   |      Symbol      |      Description       | Default |    Unit     |  Properties  |
+=========+==================+========================+=========+=============+==============+
|  idx    |                  | unique device idx      |         |             |              |
+---------+------------------+------------------------+---------+-------------+--------------+
|  u      | :math:`u`        | connection status      | 1       | *bool*      |              |
+---------+------------------+------------------------+---------+-------------+--------------+
|  name   |                  | device name            |         |             |              |
+---------+------------------+------------------------+---------+-------------+--------------+
|  rego   |                  | Renewable governor idx |         |             | mandatory    |
+---------+------------------+------------------------+---------+-------------+--------------+
|  Ka     | :math:`K_a`      | Aerodynamics gain      | 1       | *p.u./deg.* | non_negative |
+---------+------------------+------------------------+---------+-------------+--------------+
|  theta0 | :math:`\theta_0` | Initial pitch angle    | 0       | *deg.*      |              |
+---------+------------------+------------------------+---------+-------------+--------------+

Variables
---------

+--------+----------------+----------+-------------+-------+------------+
|  Name  |     Symbol     |   Type   | Description | Unit  | Properties |
+========+================+==========+=============+=======+============+
|  theta | :math:`\theta` | Algeb    | Pitch angle | *rad* | v_str      |
+--------+----------------+----------+-------------+-------+------------+
|  Pmg   | :math:`Pmg`    | ExtAlgeb |             |       |            |
+--------+----------------+----------+-------------+-------+------------+

Initialization Equations
------------------------

+--------+----------------+----------+-----------------+
|  Name  |     Symbol     |   Type   |  Initial Value  |
+========+================+==========+=================+
|  theta | :math:`\theta` | Algeb    | :math:`theta0r` |
+--------+----------------+----------+-----------------+
|  Pmg   | :math:`Pmg`    | ExtAlgeb |                 |
+--------+----------------+----------+-----------------+

Algebraic Equations
-----------------------------

+--------+----------------+----------+------------------------------------------------------+
|  Name  |     Symbol     |   Type   |            RHS of Equation "0 = g(x, y)"             |
+========+================+==========+======================================================+
|  theta | :math:`\theta` | Algeb    | :math:`- \theta + theta0r`                           |
+--------+----------------+----------+------------------------------------------------------+
|  Pmg   | :math:`Pmg`    | ExtAlgeb | :math:`- Ka \theta \left(\theta - \theta_{0}\right)` |
+--------+----------------+----------+------------------------------------------------------+

Services
----------

+----------+---------------------+------------------------------------+--------------+
|   Name   |       Symbol        |              Equation              |     Type     |
+==========+=====================+====================================+==============+
|  theta0r | :math:`\theta_{0r}` | :math:`\frac{\pi \theta_{0}}{180}` | ConstService |
+----------+---------------------+------------------------------------+--------------+


Config Fields in [WTARA1]

+---------------+--------+-------+---------------------------------------+-----------------+
|    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)          |
+---------------+--------+-------+---------------------------------------+-----------------+


.. _WTARV1:

--------------------------------------------------------------------------------
WTARV1
--------------------------------------------------------------------------------
Wind turbine aerodynamics model with wind velocity details.

Work is in progress.

Parameters
----------

+---------+-------------+--------------------------------+---------+---------+------------+
|  Name   |   Symbol    |          Description           | Default |  Unit   | Properties |
+=========+=============+================================+=========+=========+============+
|  idx    |             | unique device idx              |         |         |            |
+---------+-------------+--------------------------------+---------+---------+------------+
|  u      | :math:`u`   | connection status              | 1       | *bool*  |            |
+---------+-------------+--------------------------------+---------+---------+------------+
|  name   |             | device name                    |         |         |            |
+---------+-------------+--------------------------------+---------+---------+------------+
|  rego   |             | Renewable governor idx         |         |         | mandatory  |
+---------+-------------+--------------------------------+---------+---------+------------+
|  nblade |             | number of blades               | 3       |         |            |
+---------+-------------+--------------------------------+---------+---------+------------+
|  ngen   |             | number of wind generator units | 50      |         |            |
+---------+-------------+--------------------------------+---------+---------+------------+
|  npole  |             | number of poles in generator   | 4       |         |            |
+---------+-------------+--------------------------------+---------+---------+------------+
|  R      |             | rotor radius                   | 30      | *m*     |            |
+---------+-------------+--------------------------------+---------+---------+------------+
|  ngb    |             | gear box ratio                 | 5       |         |            |
+---------+-------------+--------------------------------+---------+---------+------------+
|  rho    |             | air density                    | 1.200   | *kg/m3* |            |
+---------+-------------+--------------------------------+---------+---------+------------+
|  Sn     | :math:`S_n` |                                | 0       |         |            |
+---------+-------------+--------------------------------+---------+---------+------------+

Variables
---------

+--------+----------------+----------+-------------+-------+------------+
|  Name  |     Symbol     |   Type   | Description | Unit  | Properties |
+========+================+==========+=============+=======+============+
|  theta | :math:`\theta` | Algeb    | Pitch angle | *rad* |            |
+--------+----------------+----------+-------------+-------+------------+
|  Pmg   | :math:`Pmg`    | ExtAlgeb |             |       |            |
+--------+----------------+----------+-------------+-------+------------+

Initialization Equations
------------------------

+--------+----------------+----------+---------------+
|  Name  |     Symbol     |   Type   | Initial Value |
+========+================+==========+===============+
|  theta | :math:`\theta` | Algeb    |               |
+--------+----------------+----------+---------------+
|  Pmg   | :math:`Pmg`    | ExtAlgeb |               |
+--------+----------------+----------+---------------+

Algebraic Equations
-----------------------------

+--------+----------------+----------+-------------------------------+
|  Name  |     Symbol     |   Type   | RHS of Equation "0 = g(x, y)" |
+========+================+==========+===============================+
|  theta | :math:`\theta` | Algeb    | :math:`0`                     |
+--------+----------------+----------+-------------------------------+
|  Pmg   | :math:`Pmg`    | ExtAlgeb | :math:`0`                     |
+--------+----------------+----------+-------------------------------+


Config Fields in [WTARV1]

+---------------+--------+-------+---------------------------------------+-----------------+
|    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)          |
+---------------+--------+-------+---------------------------------------+-----------------+