.. _StaticACDC: ================================================================================ StaticACDC ================================================================================ AC DC device for power flow Common Parameters: u, name Available models: VSCShunt_ .. _VSCShunt: -------------------------------------------------------------------------------- VSCShunt -------------------------------------------------------------------------------- Data for VSC Shunt in power flow Parameters ---------- +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | Name | Symbol | Description | Default | Unit | Properties | +==========+==================+===========================================================+=========+===========+============+ | idx | | unique device idx | | | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | u | :math:`u` | connection status | 1 | *bool* | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | name | | device name | | | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | bus | | idx of connected bus | | | mandatory | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | node1 | | Node 1 index | | | mandatory | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | node2 | | Node 2 index | | | mandatory | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | Vn | :math:`V_n` | AC voltage rating | 110 | | non_zero | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | Vdcn1 | :math:`V_{dcn1}` | DC voltage rating on node 1 | 100 | *kV* | non_zero | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | Vdcn2 | :math:`V_{dcn2}` | DC voltage rating on node 2 | 100 | *kV* | non_zero | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | Idcn | :math:`I_{dcn}` | DC current rating | 1 | *kA* | non_zero | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | rsh | :math:`r_{sh}` | AC interface resistance | 0.003 | *ohm* | z | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | xsh | :math:`x_{sh}` | AC interface reactance | 0.060 | *ohm* | z | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | control | | Control method: 0-PQ, 1-PV, 2-vQ or 3-vV | | | mandatory | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | v0 | | AC voltage setting (PV or vV) or initial guess (PQ or vQ) | 1 | | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | p0 | | AC active power setting | 0 | *pu* | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | q0 | | AC reactive power setting | 0 | *pu* | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | vdc0 | :math:`v_{dc0}` | DC voltage setting | 1 | *pu* | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | k0 | | Loss coefficient - constant | 0 | | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | k1 | | Loss coefficient - linear | 0 | | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | k2 | | Loss coefficient - quadratic | 0 | | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | droop | | Enable dc voltage droop control | 0 | *boolean* | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | K | | Droop coefficient | 0 | | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | vhigh | | Upper voltage threshold in droop control | 9999 | *pu* | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | vlow | | Lower voltage threshold in droop control | 0 | *pu* | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | vshmax | | Maximum ac interface voltage | 1.100 | *pu* | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | vshmin | | Minimum ac interface voltage | 0.900 | *pu* | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ | Ishmax | | Maximum ac current | 2 | *pu* | | +----------+------------------+-----------------------------------------------------------+---------+-----------+------------+ Variables --------- +------+---------------------+----------+--------------------------------------+--------+------------+ | Name | Symbol | Type | Description | Unit | Properties | +======+=====================+==========+======================================+========+============+ | ash | :math:`\theta_{sh}` | Algeb | voltage phase behind the transformer | *rad* | v_str | +------+---------------------+----------+--------------------------------------+--------+------------+ | vsh | :math:`V_{sh}` | Algeb | voltage magnitude behind transformer | *p.u.* | v_str | +------+---------------------+----------+--------------------------------------+--------+------------+ | psh | :math:`P_{sh}` | Algeb | active power injection into VSC | *p.u.* | v_str | +------+---------------------+----------+--------------------------------------+--------+------------+ | qsh | :math:`Q_{sh}` | Algeb | reactive power injection into VSC | | v_str | +------+---------------------+----------+--------------------------------------+--------+------------+ | pdc | :math:`P_{dc}` | Algeb | DC power injection | | v_str | +------+---------------------+----------+--------------------------------------+--------+------------+ | a | :math:`a` | ExtAlgeb | AC bus voltage phase | | | +------+---------------------+----------+--------------------------------------+--------+------------+ | v | :math:`v` | ExtAlgeb | AC bus voltage magnitude | | | +------+---------------------+----------+--------------------------------------+--------+------------+ | v1 | :math:`v_{1}` | ExtAlgeb | DC node 1 voltage | | | +------+---------------------+----------+--------------------------------------+--------+------------+ | v2 | :math:`v_{2}` | ExtAlgeb | DC node 2 voltage | | | +------+---------------------+----------+--------------------------------------+--------+------------+ Initialization Equations ------------------------ +------+---------------------+----------+--------------------------------------------------------+ | Name | Symbol | Type | Initial Value | +======+=====================+==========+========================================================+ | ash | :math:`\theta_{sh}` | Algeb | :math:`a` | +------+---------------------+----------+--------------------------------------------------------+ | vsh | :math:`V_{sh}` | Algeb | :math:`v_{0}` | +------+---------------------+----------+--------------------------------------------------------+ | psh | :math:`P_{sh}` | Algeb | :math:`p_{0} \left(s_{0}^{mode} + s_{1}^{mode}\right)` | +------+---------------------+----------+--------------------------------------------------------+ | qsh | :math:`Q_{sh}` | Algeb | :math:`q_{0} \left(s_{0}^{mode} + s_{2}^{mode}\right)` | +------+---------------------+----------+--------------------------------------------------------+ | pdc | :math:`P_{dc}` | Algeb | :math:`0` | +------+---------------------+----------+--------------------------------------------------------+ | a | :math:`a` | ExtAlgeb | | +------+---------------------+----------+--------------------------------------------------------+ | v | :math:`v` | ExtAlgeb | | +------+---------------------+----------+--------------------------------------------------------+ | v1 | :math:`v_{1}` | ExtAlgeb | | +------+---------------------+----------+--------------------------------------------------------+ | v2 | :math:`v_{2}` | ExtAlgeb | | +------+---------------------+----------+--------------------------------------------------------+ Algebraic Equations ----------------------------- +------+---------------------+----------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | Name | Symbol | Type | RHS of Equation "0 = g(x, y)" | +======+=====================+==========+====================================================================================================================================================================+ | ash | :math:`\theta_{sh}` | Algeb | :math:`- P_{sh} + u \left(V_{sh} b_{sh} v \sin{\left(\theta_{sh} - a \right)} - V_{sh} g_{sh} v \cos{\left(\theta_{sh} - a \right)} + g_{sh} v^{2}\right)` | +------+---------------------+----------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | vsh | :math:`V_{sh}` | Algeb | :math:`- Q_{sh} + u \left(V_{sh} b_{sh} v \cos{\left(\theta_{sh} - a \right)} + V_{sh} g_{sh} v \sin{\left(\theta_{sh} - a \right)} - b_{sh} v^{2}\right)` | +------+---------------------+----------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | psh | :math:`P_{sh}` | Algeb | :math:`u \left(- P_{sh} + p_{0}\right) \left(s_{0}^{mode} + s_{1}^{mode}\right) + u \left(s_{2}^{mode} + s_{3}^{mode}\right) \left(v_{1} - v_{2} - v_{dc0}\right)` | +------+---------------------+----------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | qsh | :math:`Q_{sh}` | Algeb | :math:`u \left(- Q_{sh} + q_{0}\right) \left(s_{0}^{mode} + s_{2}^{mode}\right) + u \left(s_{1}^{mode} + s_{3}^{mode}\right) \left(- v + v_{0}\right)` | +------+---------------------+----------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | pdc | :math:`P_{dc}` | Algeb | :math:`P_{dc} + u \left(V_{sh}^{2} g_{sh} - V_{sh} b_{sh} v \sin{\left(\theta_{sh} - a \right)} - V_{sh} g_{sh} v \cos{\left(\theta_{sh} - a \right)}\right)` | +------+---------------------+----------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | a | :math:`a` | ExtAlgeb | :math:`- P_{sh}` | +------+---------------------+----------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | v | :math:`v` | ExtAlgeb | :math:`- Q_{sh}` | +------+---------------------+----------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | v1 | :math:`v_{1}` | ExtAlgeb | :math:`- \frac{P_{dc}}{v_{1} - v_{2}}` | +------+---------------------+----------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | v2 | :math:`v_{2}` | ExtAlgeb | :math:`\frac{P_{dc}}{v_{1} - v_{2}}` | +------+---------------------+----------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+ Services ---------- +------+----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------+ | Name | Symbol | Equation | Type | +======+================+=======================================================================================================================================================================================================================================================================================================+==============+ | gsh | :math:`g_{sh}` | :math:`\frac{\operatorname{re}{\left(r_{sh}\right)} - \operatorname{im}{\left(x_{sh}\right)}}{\left(\operatorname{re}{\left(r_{sh}\right)} - \operatorname{im}{\left(x_{sh}\right)}\right)^{2} + \left(\operatorname{re}{\left(x_{sh}\right)} + \operatorname{im}{\left(r_{sh}\right)}\right)^{2}}` | ConstService | +------+----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------+ | bsh | :math:`b_{sh}` | :math:`\frac{- \operatorname{re}{\left(x_{sh}\right)} - \operatorname{im}{\left(r_{sh}\right)}}{\left(\operatorname{re}{\left(r_{sh}\right)} - \operatorname{im}{\left(x_{sh}\right)}\right)^{2} + \left(\operatorname{re}{\left(x_{sh}\right)} + \operatorname{im}{\left(r_{sh}\right)}\right)^{2}}` | ConstService | +------+----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------+ Discretes ----------- +-------+--------------+----------+------+ | Name | Symbol | Type | Info | +=======+==============+==========+======+ | mode | :math:`mode` | Switcher | | +-------+--------------+----------+------+ Config Fields in [VSCShunt] +---------------+--------+-------+---------------------------------------+-----------------+ | 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) | +---------------+--------+-------+---------------------------------------+-----------------+