Filtering in GUI
================

This example compares several GUI filtering configurations based on the IBSI II
phantom and shows how the corresponding filter setup looks in Z-Rad.

Filtering results
-----------------

.. figure:: ../images/Filtering_Res.png
   :alt: Comparison of filtering results
   :width: 800

   Filtering results on the IBSI II phantom: unfiltered, 3D mean, 3D LoG, and
   3D wavelet responses.

The archive example compares:

* no filtering
* a ``3D`` mean filter with reflect padding and support ``5``
* a ``3D`` LoG filter with reflect padding, ``1.5`` mm scale, and ``4 sigma`` cutoff
* a ``3D`` Daubechies 3 wavelet filter with first-level ``LLH`` response and
  pseudo-rotational invariance

Mean filter example
-------------------

.. figure:: ../images/Filt_mean.png
   :alt: Example mean filter configuration
   :width: 700

   Example configuration for a ``3D`` mean filter.

LoG filter example
------------------

.. figure:: ../images/Filt_LoG.png
   :alt: Example LoG filter configuration
   :width: 700

   Example configuration for a ``3D`` Laplacian-of-Gaussian filter.

Wavelet filter example
----------------------

.. figure:: ../images/Filt_wavelet.png
   :alt: Example wavelet filter configuration
   :width: 700

   Example configuration for a ``3D`` Daubechies 3 wavelet filter.

Additional filter controls
--------------------------

The filter selector also provides ``Riesz-transformed LoG`` and
``Simoncelli``. Riesz-transformed LoG exposes the LoG scale and cutoff, a
Riesz multi-index, and an optional structure-tensor scale. Simoncelli exposes
the decomposition level and an optional Riesz multi-index; its padding choices
are ``nearest`` and ``wrap``.

See also :doc:`../user/filtering` for the full filtering guide.