.. _ACTopology:

================================================================================
ACTopology
================================================================================
Common Parameters: u, name, idx

Common Variables: a, v

Available models:
Bus_

.. _Bus:

--------------------------------------------------------------------------------
Bus
--------------------------------------------------------------------------------
AC Bus model.

Parameters
----------

+---------+------------------+-----------------------------+---------+--------+------------+
|  Name   |      Symbol      |         Description         | Default |  Unit  | Properties |
+=========+==================+=============================+=========+========+============+
|  idx    |                  | unique device idx           |         |        |            |
+---------+------------------+-----------------------------+---------+--------+------------+
|  u      | :math:`u`        | connection status           | 1       | *bool* |            |
+---------+------------------+-----------------------------+---------+--------+------------+
|  name   |                  | device name                 |         |        |            |
+---------+------------------+-----------------------------+---------+--------+------------+
|  Vn     | :math:`V_n`      | AC voltage rating           | 110     | *kV*   | non_zero   |
+---------+------------------+-----------------------------+---------+--------+------------+
|  vmax   | :math:`V_{max}`  | Voltage upper limit         | 1.100   | *p.u.* |            |
+---------+------------------+-----------------------------+---------+--------+------------+
|  vmin   | :math:`V_{min}`  | Voltage lower limit         | 0.900   | *p.u.* |            |
+---------+------------------+-----------------------------+---------+--------+------------+
|  v0     | :math:`V_0`      | initial voltage magnitude   | 1       | *p.u.* | non_zero   |
+---------+------------------+-----------------------------+---------+--------+------------+
|  a0     | :math:`\theta_0` | initial voltage phase angle | 0       | *rad*  |            |
+---------+------------------+-----------------------------+---------+--------+------------+
|  xcoord |                  | x coordinate (longitude)    | 0       |        |            |
+---------+------------------+-----------------------------+---------+--------+------------+
|  ycoord |                  | y coordinate (latitude)     | 0       |        |            |
+---------+------------------+-----------------------------+---------+--------+------------+
|  area   |                  | Area code                   |         |        |            |
+---------+------------------+-----------------------------+---------+--------+------------+
|  zone   |                  | Zone code                   |         |        |            |
+---------+------------------+-----------------------------+---------+--------+------------+
|  owner  |                  | Owner code                  |         |        |            |
+---------+------------------+-----------------------------+---------+--------+------------+

Variables
---------

+------+----------------+-------+-------------------+--------+
| Name |     Symbol     | Type  |    Description    |  Unit  |
+======+================+=======+===================+========+
|  a   | :math:`\theta` | Algeb | voltage angle     | *rad*  |
+------+----------------+-------+-------------------+--------+
|  v   | :math:`V`      | Algeb | voltage magnitude | *p.u.* |
+------+----------------+-------+-------------------+--------+