.. _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.020 | *sec* | | +-------+-------------+---------------------------------+---------+--------+------------+ | fn | :math:`f_n` | nominal frequency | 60 | *Hz* | | +-------+-------------+---------------------------------+---------+--------+------------+ Variables --------- +-------+-----------------+----------+--------------------------------+-------------+------------+ | Name | Symbol | Type | Description | Unit | Properties | +=======+=================+==========+================================+=============+============+ | L_y | :math:`y_{L}` | State | State in lag transfer function | | v_str | +-------+-----------------+----------+--------------------------------+-------------+------------+ | WO_x | :math:`x'_{WO}` | State | State in washout filter | | v_str | +-------+-----------------+----------+--------------------------------+-------------+------------+ | WO_y | :math:`y_{WO}` | Algeb | frequency deviation | *p.u. (Hz)* | v_str | +-------+-----------------+----------+--------------------------------+-------------+------------+ | f | :math:`f` | Algeb | frequency output | *p.u. (Hz)* | v_str | +-------+-----------------+----------+--------------------------------+-------------+------------+ | a | :math:`\theta` | ExtAlgeb | | | | +-------+-----------------+----------+--------------------------------+-------------+------------+ | v | :math:`V` | ExtAlgeb | | | | +-------+-----------------+----------+--------------------------------+-------------+------------+ Initialization Equations ------------------------ +-------+-----------------+----------+-----------------------------+ | Name | Symbol | Type | Initial Value | +=======+=================+==========+=============================+ | L_y | :math:`y_{L}` | State | :math:`\theta - \theta_{0}` | +-------+-----------------+----------+-----------------------------+ | WO_x | :math:`x'_{WO}` | State | :math:`y_{L}` | +-------+-----------------+----------+-----------------------------+ | WO_y | :math:`y_{WO}` | Algeb | :math:`0` | +-------+-----------------+----------+-----------------------------+ | f | :math:`f` | Algeb | :math:`1` | +-------+-----------------+----------+-----------------------------+ | a | :math:`\theta` | ExtAlgeb | | +-------+-----------------+----------+-----------------------------+ | v | :math:`V` | ExtAlgeb | | +-------+-----------------+----------+-----------------------------+ Differential Equations ----------------------------- +-------+-----------------+-------+-------------------------------------+-------------+ | Name | Symbol | Type | RHS of Equation "T x' = f(x, y)" | T (LHS) | +=======+=================+=======+=====================================+=============+ | L_y | :math:`y_{L}` | State | :math:`\theta - \theta_{0} - y_{L}` | :math:`T_f` | +-------+-----------------+-------+-------------------------------------+-------------+ | WO_x | :math:`x'_{WO}` | State | :math:`- x'_{WO} + y_{L}` | :math:`T_w` | +-------+-----------------+-------+-------------------------------------+-------------+ Algebraic Equations ----------------------------- +-------+----------------+----------+--------------------------------------------------------------------+ | Name | Symbol | Type | RHS of Equation "0 = g(x, y)" | +=======+================+==========+====================================================================+ | WO_y | :math:`y_{WO}` | Algeb | :math:`1/\omega_{n} \left(- x'_{WO} + y_{L}\right) - T_{w} y_{WO}` | +-------+----------------+----------+--------------------------------------------------------------------+ | f | :math:`f` | Algeb | :math:`- f + y_{WO} + 1` | +-------+----------------+----------+--------------------------------------------------------------------+ | a | :math:`\theta` | ExtAlgeb | :math:`0` | +-------+----------------+----------+--------------------------------------------------------------------+ | v | :math:`V` | ExtAlgeb | :math:`0` | +-------+----------------+----------+--------------------------------------------------------------------+ Services ---------- +------+--------------------+-------------------------------+--------------+ | Name | Symbol | Equation | Type | +======+====================+===============================+==============+ | iwn | :math:`1/\omega_n` | :math:`\frac{u}{2 \pi f_{n}}` | 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.020 | *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:`y_{L}` | State | State in lag transfer function | | v_str | +-------+-----------------+----------+--------------------------------+-------------+------------+ | WO_x | :math:`x'_{WO}` | State | State in washout filter | | v_str | +-------+-----------------+----------+--------------------------------+-------------+------------+ | Wf_x | :math:`x'_{Wf}` | State | State in washout filter | | v_str | +-------+-----------------+----------+--------------------------------+-------------+------------+ | WO_y | :math:`y_{WO}` | Algeb | frequency deviation | *p.u. (Hz)* | v_str | +-------+-----------------+----------+--------------------------------+-------------+------------+ | f | :math:`f` | Algeb | frequency output | *p.u. (Hz)* | v_str | +-------+-----------------+----------+--------------------------------+-------------+------------+ | Wf_y | :math:`y_{Wf}` | Algeb | Output of washout filter | | v_str | +-------+-----------------+----------+--------------------------------+-------------+------------+ | a | :math:`\theta` | ExtAlgeb | | | | +-------+-----------------+----------+--------------------------------+-------------+------------+ | v | :math:`V` | ExtAlgeb | | | | +-------+-----------------+----------+--------------------------------+-------------+------------+ Initialization Equations ------------------------ +-------+-----------------+----------+-----------------------------+ | Name | Symbol | Type | Initial Value | +=======+=================+==========+=============================+ | L_y | :math:`y_{L}` | State | :math:`\theta - \theta_{0}` | +-------+-----------------+----------+-----------------------------+ | WO_x | :math:`x'_{WO}` | State | :math:`y_{L}` | +-------+-----------------+----------+-----------------------------+ | Wf_x | :math:`x'_{Wf}` | State | :math:`f` | +-------+-----------------+----------+-----------------------------+ | WO_y | :math:`y_{WO}` | Algeb | :math:`0` | +-------+-----------------+----------+-----------------------------+ | f | :math:`f` | Algeb | :math:`1` | +-------+-----------------+----------+-----------------------------+ | Wf_y | :math:`y_{Wf}` | Algeb | :math:`0` | +-------+-----------------+----------+-----------------------------+ | a | :math:`\theta` | ExtAlgeb | | +-------+-----------------+----------+-----------------------------+ | v | :math:`V` | ExtAlgeb | | +-------+-----------------+----------+-----------------------------+ Differential Equations ----------------------------- +-------+-----------------+-------+-------------------------------------+-------------+ | Name | Symbol | Type | RHS of Equation "T x' = f(x, y)" | T (LHS) | +=======+=================+=======+=====================================+=============+ | L_y | :math:`y_{L}` | State | :math:`\theta - \theta_{0} - y_{L}` | :math:`T_f` | +-------+-----------------+-------+-------------------------------------+-------------+ | WO_x | :math:`x'_{WO}` | State | :math:`- x'_{WO} + y_{L}` | :math:`T_w` | +-------+-----------------+-------+-------------------------------------+-------------+ | Wf_x | :math:`x'_{Wf}` | State | :math:`f - x'_{Wf}` | :math:`T_r` | +-------+-----------------+-------+-------------------------------------+-------------+ Algebraic Equations ----------------------------- +-------+----------------+----------+--------------------------------------------------------------------+ | Name | Symbol | Type | RHS of Equation "0 = g(x, y)" | +=======+================+==========+====================================================================+ | WO_y | :math:`y_{WO}` | Algeb | :math:`1/\omega_{n} \left(- x'_{WO} + y_{L}\right) - T_{w} y_{WO}` | +-------+----------------+----------+--------------------------------------------------------------------+ | f | :math:`f` | Algeb | :math:`- f + y_{WO} + 1` | +-------+----------------+----------+--------------------------------------------------------------------+ | Wf_y | :math:`y_{Wf}` | Algeb | :math:`- T_{r} y_{Wf} + f - x'_{Wf}` | +-------+----------------+----------+--------------------------------------------------------------------+ | a | :math:`\theta` | ExtAlgeb | :math:`0` | +-------+----------------+----------+--------------------------------------------------------------------+ | v | :math:`V` | ExtAlgeb | :math:`0` | +-------+----------------+----------+--------------------------------------------------------------------+ Services ---------- +------+--------------------+-------------------------------+--------------+ | Name | Symbol | Equation | Type | +======+====================+===============================+==============+ | iwn | :math:`1/\omega_n` | :math:`\frac{u}{2 \pi f_{n}}` | 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) | +---------------+--------+-------+---------------------------------------+-----------------+