Tuning the reflection update period
===================================

.. admonition:: Tutorial goal

   Explore the speed/quality tradeoff from updating reflection coefficients less frequently.

.. note::

   New to the terminology? See the :doc:`lattice DSP concept map <../../algorithms/concept_map>` and the :doc:`causality/data-use guide <../../theory/causality_and_data_use>` for how online, offline, block, and MIMO examples should be read.

Context
-------

Updating denominator parameters can be more expensive than updating numerator taps.  This
tutorial sweeps the reflection update period and reports which periods preserve quality while
reducing work.

Key idea and equations
----------------------

A period ``P`` updates reflection coefficients only when

.. math::

   n \equiv 0 \pmod P.

How to read the result
----------------------

Look for the largest period that keeps the tail MSE close to the period-1 baseline.

Run command
-----------

.. code-block:: bash

   python examples/tune_reflection_update_period.py

Source code
-----------

.. literalinclude:: ../../../examples/tune_reflection_update_period.py
   :language: python
   :linenos: