.. _PF:

================================================================================
PF
================================================================================
Type for power flow routines.

Common Parameters: pd

Common Vars: pg

Available routines:
DCPF_,
PFlow_,
CPF_

.. _DCPF:

--------------------------------------------------------------------------------
DCPF
--------------------------------------------------------------------------------
DC power flow.

Notes
-----
1. DCPF is solved with PYPOWER ``runpf`` function.
2. DCPF formulation is not complete yet, but this does not affect the
   results because the data are passed to PYPOWER for solving.

Vars
----------------------------------

+-------+-----------------+--------------------------------+--------+-------------+------------+
| Name  |     Symbol      |          Description           |  Unit  |   Source    | Properties |
+=======+=================+================================+========+=============+============+
|  aBus | :math:`a_{Bus}` | bus voltage angle              | *rad*  | Bus.a       |            |
+-------+-----------------+--------------------------------+--------+-------------+------------+
|  pg   | :math:`p_{g}`   | actual active power generation | *p.u.* | StaticGen.p |            |
+-------+-----------------+--------------------------------+--------+-------------+------------+

Parameters
----------------------------------

+------+----------------+---------------------------------------+----------+---------------+
| Name |     Symbol     |              Description              |   Unit   |    Source     |
+======+================+=======================================+==========+===============+
|  x   | :math:`x`      | line reactance                        | *p.u.*   | Line.x        |
+------+----------------+---------------------------------------+----------+---------------+
|  tap | :math:`t_{ap}` | transformer branch tap ratio          | *float*  | Line.tap      |
+------+----------------+---------------------------------------+----------+---------------+
|  phi | :math:`\phi`   | transformer branch phase shift in rad | *radian* | Line.phi      |
+------+----------------+---------------------------------------+----------+---------------+
|  pd  | :math:`p_{d}`  | active deman                          | *p.u.*   | StaticLoad.p0 |
+------+----------------+---------------------------------------+----------+---------------+


.. _PFlow:

--------------------------------------------------------------------------------
PFlow
--------------------------------------------------------------------------------
AC Power Flow routine.

Notes
-----
1. AC pwoer flow is solved with PYPOWER ``runpf`` function.
2. AC power flow formulation in AMS style is NOT DONE YET,
   but this does not affect the results
   because the data are passed to PYPOWER for solving.

Vars
----------------------------------

+-------+-----------------+---------------------------+--------+-------------+------------+
| Name  |     Symbol      |        Description        |  Unit  |   Source    | Properties |
+=======+=================+===========================+========+=============+============+
|  aBus | :math:`a_{Bus}` | bus voltage angle         | *rad*  | Bus.a       |            |
+-------+-----------------+---------------------------+--------+-------------+------------+
|  vBus | :math:`v_{Bus}` | bus voltage magnitude     | *p.u.* | Bus.v       |            |
+-------+-----------------+---------------------------+--------+-------------+------------+
|  pg   | :math:`p_{g}`   | active power generation   | *p.u.* | StaticGen.p |            |
+-------+-----------------+---------------------------+--------+-------------+------------+
|  qg   | :math:`q_{g}`   | reactive power generation | *p.u.* | StaticGen.q |            |
+-------+-----------------+---------------------------+--------+-------------+------------+

Parameters
----------------------------------

+------+----------------+---------------------------------------+----------+---------------+
| Name |     Symbol     |              Description              |   Unit   |    Source     |
+======+================+=======================================+==========+===============+
|  x   | :math:`x`      | line reactance                        | *p.u.*   | Line.x        |
+------+----------------+---------------------------------------+----------+---------------+
|  tap | :math:`t_{ap}` | transformer branch tap ratio          | *float*  | Line.tap      |
+------+----------------+---------------------------------------+----------+---------------+
|  phi | :math:`\phi`   | transformer branch phase shift in rad | *radian* | Line.phi      |
+------+----------------+---------------------------------------+----------+---------------+
|  pd  | :math:`p_{d}`  | active deman                          | *p.u.*   | StaticLoad.p0 |
+------+----------------+---------------------------------------+----------+---------------+
|  qd  | :math:`q_{d}`  | reactive power load in system base    | *p.u.*   | StaticLoad.q0 |
+------+----------------+---------------------------------------+----------+---------------+


.. _CPF:

--------------------------------------------------------------------------------
CPF
--------------------------------------------------------------------------------
Continuous power flow.

Still under development, not ready for use.

Vars
----------------------------------

+-------+-----------------+---------------------------+--------+-------------+------------+
| Name  |     Symbol      |        Description        |  Unit  |   Source    | Properties |
+=======+=================+===========================+========+=============+============+
|  aBus | :math:`a_{Bus}` | bus voltage angle         | *rad*  | Bus.a       |            |
+-------+-----------------+---------------------------+--------+-------------+------------+
|  vBus | :math:`v_{Bus}` | bus voltage magnitude     | *p.u.* | Bus.v       |            |
+-------+-----------------+---------------------------+--------+-------------+------------+
|  pg   | :math:`p_{g}`   | active power generation   | *p.u.* | StaticGen.p |            |
+-------+-----------------+---------------------------+--------+-------------+------------+
|  qg   | :math:`q_{g}`   | reactive power generation | *p.u.* | StaticGen.q |            |
+-------+-----------------+---------------------------+--------+-------------+------------+

Parameters
----------------------------------

+------+----------------+---------------------------------------+----------+---------------+
| Name |     Symbol     |              Description              |   Unit   |    Source     |
+======+================+=======================================+==========+===============+
|  x   | :math:`x`      | line reactance                        | *p.u.*   | Line.x        |
+------+----------------+---------------------------------------+----------+---------------+
|  tap | :math:`t_{ap}` | transformer branch tap ratio          | *float*  | Line.tap      |
+------+----------------+---------------------------------------+----------+---------------+
|  phi | :math:`\phi`   | transformer branch phase shift in rad | *radian* | Line.phi      |
+------+----------------+---------------------------------------+----------+---------------+
|  pd  | :math:`p_{d}`  | active deman                          | *p.u.*   | StaticLoad.p0 |
+------+----------------+---------------------------------------+----------+---------------+
|  qd  | :math:`q_{d}`  | reactive power load in system base    | *p.u.*   | StaticLoad.q0 |
+------+----------------+---------------------------------------+----------+---------------+