.. _ACShort: ================================================================================ ACShort ================================================================================ Common Parameters: u, name, bus1, bus2 Common Variables: v1, v2, a1, a2 Available models: Jumper_ .. _Jumper: -------------------------------------------------------------------------------- Jumper -------------------------------------------------------------------------------- Jumper is a device to short two buses (merging two buses into one). Jumper can connect two buses satisfying one of the following conditions: - neither bus is voltage-controlled - either bus is voltage-controlled - both buses are voltage-controlled, and the voltages are the same. If the buses are controlled in different voltages, power flow will not solve (as the power flow through the jumper will be infinite). In the solutions, the ``p`` and ``q`` are flowing out of bus1 and flowing into bus2. Setting a Jumper's connectivity status ``u`` to zero will disconnect the two buses. In the case of a system split, one will need to call ``System.connectivity()`` immediately following the split to detect islands. Parameters ---------- +-------+-----------+-------------------+---------+--------+------------+ | Name | Symbol | Description | Default | Unit | Properties | +=======+===========+===================+=========+========+============+ | idx | | unique device idx | | | | +-------+-----------+-------------------+---------+--------+------------+ | u | :math:`u` | connection status | 1 | *bool* | | +-------+-----------+-------------------+---------+--------+------------+ | name | | device name | | | | +-------+-----------+-------------------+---------+--------+------------+ | bus1 | | idx of from bus | | | | +-------+-----------+-------------------+---------+--------+------------+ | bus2 | | idx of to bus | | | | +-------+-----------+-------------------+---------+--------+------------+ Variables --------- +------+---------------+----------+-----------------------------------+------+------------+ | Name | Symbol | Type | Description | Unit | Properties | +======+===============+==========+===================================+======+============+ | p | :math:`P` | Algeb | active power (1 to 2) | | | +------+---------------+----------+-----------------------------------+------+------------+ | q | :math:`Q` | Algeb | active power (1 to 2) | | | +------+---------------+----------+-----------------------------------+------+------------+ | a1 | :math:`a_{1}` | ExtAlgeb | phase angle of the from bus | | | +------+---------------+----------+-----------------------------------+------+------------+ | a2 | :math:`a_{2}` | ExtAlgeb | phase angle of the to bus | | | +------+---------------+----------+-----------------------------------+------+------------+ | v1 | :math:`v_{1}` | ExtAlgeb | voltage magnitude of the from bus | | | +------+---------------+----------+-----------------------------------+------+------------+ | v2 | :math:`v_{2}` | ExtAlgeb | voltage magnitude of the to bus | | | +------+---------------+----------+-----------------------------------+------+------------+ Initialization Equations ------------------------ +------+---------------+----------+---------------+ | Name | Symbol | Type | Initial Value | +======+===============+==========+===============+ | p | :math:`P` | Algeb | | +------+---------------+----------+---------------+ | q | :math:`Q` | Algeb | | +------+---------------+----------+---------------+ | a1 | :math:`a_{1}` | ExtAlgeb | | +------+---------------+----------+---------------+ | a2 | :math:`a_{2}` | ExtAlgeb | | +------+---------------+----------+---------------+ | v1 | :math:`v_{1}` | ExtAlgeb | | +------+---------------+----------+---------------+ | v2 | :math:`v_{2}` | ExtAlgeb | | +------+---------------+----------+---------------+ Algebraic Equations ----------------------------- +------+---------------+----------+-------------------------------------------------------------+ | Name | Symbol | Type | RHS of Equation "0 = g(x, y)" | +======+===============+==========+=============================================================+ | p | :math:`P` | Algeb | :math:`P \left(1 - u\right) + u \left(a_{1} - a_{2}\right)` | +------+---------------+----------+-------------------------------------------------------------+ | q | :math:`Q` | Algeb | :math:`P \left(1 - u\right) + u \left(v_{1} - v_{2}\right)` | +------+---------------+----------+-------------------------------------------------------------+ | a1 | :math:`a_{1}` | ExtAlgeb | :math:`P` | +------+---------------+----------+-------------------------------------------------------------+ | a2 | :math:`a_{2}` | ExtAlgeb | :math:`- P` | +------+---------------+----------+-------------------------------------------------------------+ | v1 | :math:`v_{1}` | ExtAlgeb | :math:`Q` | +------+---------------+----------+-------------------------------------------------------------+ | v2 | :math:`v_{2}` | ExtAlgeb | :math:`- Q` | +------+---------------+----------+-------------------------------------------------------------+ Config Fields in [Jumper] +---------------+--------+-------+---------------------------------------+-----------------+ | 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) | +---------------+--------+-------+---------------------------------------+-----------------+