.. _FreqMeasurement: ================================================================================ FreqMeasurement ================================================================================ Frequency measurements. Common Parameters: u, name Common Variables: f Available models: BusFreq_, BusROCOF_ .. _BusFreq: -------------------------------------------------------------------------------- BusFreq -------------------------------------------------------------------------------- Bus frequency measurement. Outputs frequency in per unit value. The bus frequency output variable is `f`. The frequency deviation variable is `WO_y`. Parameters ---------- +-------+-------------+---------------------------------+---------+--------+------------+ | Name | Symbol | Description | Default | Unit | Properties | +=======+=============+=================================+=========+========+============+ | idx | | unique device idx | | | | +-------+-------------+---------------------------------+---------+--------+------------+ | u | :math:`u` | connection status | 1 | *bool* | | +-------+-------------+---------------------------------+---------+--------+------------+ | name | | device name | | | | +-------+-------------+---------------------------------+---------+--------+------------+ | bus | | bus idx | | | mandatory | +-------+-------------+---------------------------------+---------+--------+------------+ | Tf | :math:`T_f` | input digital filter time const | 0.020 | *sec* | | +-------+-------------+---------------------------------+---------+--------+------------+ | Tw | :math:`T_w` | washout time const | 0.100 | *sec* | | +-------+-------------+---------------------------------+---------+--------+------------+ | fn | :math:`f_n` | nominal frequency | 60 | *Hz* | | +-------+-------------+---------------------------------+---------+--------+------------+ Variables --------- +-------+----------------+----------+--------------------------------+-------------+------------+ | Name | Symbol | Type | Description | Unit | Properties | +=======+================+==========+================================+=============+============+ | L_y | :math:`L_{y}` | State | State in lag transfer function | | v_str | +-------+----------------+----------+--------------------------------+-------------+------------+ | WO_x | :math:`WO_{x}` | State | State in washout filter | | v_str | +-------+----------------+----------+--------------------------------+-------------+------------+ | WO_y | :math:`WO_{y}` | Algeb | frequency deviation | *p.u. (Hz)* | v_str | +-------+----------------+----------+--------------------------------+-------------+------------+ | f | :math:`f` | Algeb | frequency output | *p.u. (Hz)* | v_str | +-------+----------------+----------+--------------------------------+-------------+------------+ | a | :math:`a` | ExtAlgeb | | | | +-------+----------------+----------+--------------------------------+-------------+------------+ | v | :math:`v` | ExtAlgeb | | | | +-------+----------------+----------+--------------------------------+-------------+------------+ Initialization Equations ------------------------ +-------+----------------+----------+-------------------+ | Name | Symbol | Type | Initial Value | +=======+================+==========+===================+ | L_y | :math:`L_{y}` | State | :math:`a - a_{0}` | +-------+----------------+----------+-------------------+ | WO_x | :math:`WO_{x}` | State | :math:`L_{y}` | +-------+----------------+----------+-------------------+ | WO_y | :math:`WO_{y}` | Algeb | :math:`0` | +-------+----------------+----------+-------------------+ | f | :math:`f` | Algeb | :math:`1` | +-------+----------------+----------+-------------------+ | a | :math:`a` | ExtAlgeb | | +-------+----------------+----------+-------------------+ | v | :math:`v` | ExtAlgeb | | +-------+----------------+----------+-------------------+ Differential Equations ----------------------------- +-------+----------------+-------+----------------------------------+-------------+ | Name | Symbol | Type | RHS of Equation "T x' = f(x, y)" | T (LHS) | +=======+================+=======+==================================+=============+ | L_y | :math:`L_{y}` | State | :math:`- L_{y} + a - a_{0}` | :math:`T_f` | +-------+----------------+-------+----------------------------------+-------------+ | WO_x | :math:`WO_{x}` | State | :math:`L_{y} - WO_{x}` | :math:`T_w` | +-------+----------------+-------+----------------------------------+-------------+ Algebraic Equations ----------------------------- +-------+----------------+----------+-------------------------------------------------------+ | Name | Symbol | Type | RHS of Equation "0 = g(x, y)" | +=======+================+==========+=======================================================+ | WO_y | :math:`WO_{y}` | Algeb | :math:`- Tw WO_{y} + iwn \left(L_{y} - WO_{x}\right)` | +-------+----------------+----------+-------------------------------------------------------+ | f | :math:`f` | Algeb | :math:`WO_{y} - f + 1` | +-------+----------------+----------+-------------------------------------------------------+ | a | :math:`a` | ExtAlgeb | :math:`0` | +-------+----------------+----------+-------------------------------------------------------+ | v | :math:`v` | ExtAlgeb | :math:`0` | +-------+----------------+----------+-------------------------------------------------------+ Services ---------- +------+--------------------+----------------------------+--------------+ | Name | Symbol | Equation | Type | +======+====================+============================+==============+ | iwn | :math:`1/\omega_n` | :math:`\frac{u}{2 \pi fn}` | ConstService | +------+--------------------+----------------------------+--------------+ Blocks ------- +------+------------+---------+----------------+ | Name | Symbol | Type | Info | +======+============+=========+================+ | L | :math:`L` | Lag | digital filter | +------+------------+---------+----------------+ | WO | :math:`WO` | Washout | angle washout | +------+------------+---------+----------------+ Config Fields in [BusFreq] +---------------+--------+-------+---------------------------------------+-----------------+ | 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) | +---------------+--------+-------+---------------------------------------+-----------------+ .. _BusROCOF: -------------------------------------------------------------------------------- BusROCOF -------------------------------------------------------------------------------- Bus frequency and ROCOF measurement. The ROCOF output variable is ``Wf_y``. Parameters ---------- +-------+-------------+---------------------------------+---------+--------+------------+ | Name | Symbol | Description | Default | Unit | Properties | +=======+=============+=================================+=========+========+============+ | idx | | unique device idx | | | | +-------+-------------+---------------------------------+---------+--------+------------+ | u | :math:`u` | connection status | 1 | *bool* | | +-------+-------------+---------------------------------+---------+--------+------------+ | name | | device name | | | | +-------+-------------+---------------------------------+---------+--------+------------+ | bus | | bus idx | | | mandatory | +-------+-------------+---------------------------------+---------+--------+------------+ | Tf | :math:`T_f` | input digital filter time const | 0.020 | *sec* | | +-------+-------------+---------------------------------+---------+--------+------------+ | Tw | :math:`T_w` | washout time const | 0.100 | *sec* | | +-------+-------------+---------------------------------+---------+--------+------------+ | fn | :math:`f_n` | nominal frequency | 60 | *Hz* | | +-------+-------------+---------------------------------+---------+--------+------------+ | Tr | :math:`T_r` | frequency washout time constant | 0.100 | | | +-------+-------------+---------------------------------+---------+--------+------------+ Variables --------- +-------+----------------+----------+--------------------------------+-------------+------------+ | Name | Symbol | Type | Description | Unit | Properties | +=======+================+==========+================================+=============+============+ | L_y | :math:`L_{y}` | State | State in lag transfer function | | v_str | +-------+----------------+----------+--------------------------------+-------------+------------+ | WO_x | :math:`WO_{x}` | State | State in washout filter | | v_str | +-------+----------------+----------+--------------------------------+-------------+------------+ | Wf_x | :math:`Wf_{x}` | State | State in washout filter | | v_str | +-------+----------------+----------+--------------------------------+-------------+------------+ | WO_y | :math:`WO_{y}` | Algeb | frequency deviation | *p.u. (Hz)* | v_str | +-------+----------------+----------+--------------------------------+-------------+------------+ | f | :math:`f` | Algeb | frequency output | *p.u. (Hz)* | v_str | +-------+----------------+----------+--------------------------------+-------------+------------+ | Wf_y | :math:`Wf_{y}` | Algeb | Output of washout filter | | v_str | +-------+----------------+----------+--------------------------------+-------------+------------+ | a | :math:`a` | ExtAlgeb | | | | +-------+----------------+----------+--------------------------------+-------------+------------+ | v | :math:`v` | ExtAlgeb | | | | +-------+----------------+----------+--------------------------------+-------------+------------+ Initialization Equations ------------------------ +-------+----------------+----------+-------------------+ | Name | Symbol | Type | Initial Value | +=======+================+==========+===================+ | L_y | :math:`L_{y}` | State | :math:`a - a_{0}` | +-------+----------------+----------+-------------------+ | WO_x | :math:`WO_{x}` | State | :math:`L_{y}` | +-------+----------------+----------+-------------------+ | Wf_x | :math:`Wf_{x}` | State | :math:`f` | +-------+----------------+----------+-------------------+ | WO_y | :math:`WO_{y}` | Algeb | :math:`0` | +-------+----------------+----------+-------------------+ | f | :math:`f` | Algeb | :math:`1` | +-------+----------------+----------+-------------------+ | Wf_y | :math:`Wf_{y}` | Algeb | :math:`0` | +-------+----------------+----------+-------------------+ | a | :math:`a` | ExtAlgeb | | +-------+----------------+----------+-------------------+ | v | :math:`v` | ExtAlgeb | | +-------+----------------+----------+-------------------+ Differential Equations ----------------------------- +-------+----------------+-------+----------------------------------+-------------+ | Name | Symbol | Type | RHS of Equation "T x' = f(x, y)" | T (LHS) | +=======+================+=======+==================================+=============+ | L_y | :math:`L_{y}` | State | :math:`- L_{y} + a - a_{0}` | :math:`T_f` | +-------+----------------+-------+----------------------------------+-------------+ | WO_x | :math:`WO_{x}` | State | :math:`L_{y} - WO_{x}` | :math:`T_w` | +-------+----------------+-------+----------------------------------+-------------+ | Wf_x | :math:`Wf_{x}` | State | :math:`- Wf_{x} + f` | :math:`T_r` | +-------+----------------+-------+----------------------------------+-------------+ Algebraic Equations ----------------------------- +-------+----------------+----------+-------------------------------------------------------+ | Name | Symbol | Type | RHS of Equation "0 = g(x, y)" | +=======+================+==========+=======================================================+ | WO_y | :math:`WO_{y}` | Algeb | :math:`- Tw WO_{y} + iwn \left(L_{y} - WO_{x}\right)` | +-------+----------------+----------+-------------------------------------------------------+ | f | :math:`f` | Algeb | :math:`WO_{y} - f + 1` | +-------+----------------+----------+-------------------------------------------------------+ | Wf_y | :math:`Wf_{y}` | Algeb | :math:`- Tr Wf_{y} - Wf_{x} + f` | +-------+----------------+----------+-------------------------------------------------------+ | a | :math:`a` | ExtAlgeb | :math:`0` | +-------+----------------+----------+-------------------------------------------------------+ | v | :math:`v` | ExtAlgeb | :math:`0` | +-------+----------------+----------+-------------------------------------------------------+ Services ---------- +------+--------------------+----------------------------+--------------+ | Name | Symbol | Equation | Type | +======+====================+============================+==============+ | iwn | :math:`1/\omega_n` | :math:`\frac{u}{2 \pi fn}` | ConstService | +------+--------------------+----------------------------+--------------+ Blocks ------- +------+------------+---------+----------------------------------+ | Name | Symbol | Type | Info | +======+============+=========+==================================+ | L | :math:`L` | Lag | digital filter | +------+------------+---------+----------------------------------+ | WO | :math:`WO` | Washout | angle washout | +------+------------+---------+----------------------------------+ | Wf | :math:`Wf` | Washout | frequency washout yielding ROCOF | +------+------------+---------+----------------------------------+ Config Fields in [BusROCOF] +---------------+--------+-------+---------------------------------------+-----------------+ | 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) | +---------------+--------+-------+---------------------------------------+-----------------+