.. _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                                             |         |        |            |
+---------+------------------+--------------------------------------------------------+---------+--------+------------+
|  type   | :math:`type`     | bus type, 1=PQ, 2=PV, 3=ref, 4=isolated (place holder) | 1       |        |            |
+---------+------------------+--------------------------------------------------------+---------+--------+------------+

Variables
---------

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