.. _deadpixelremoval:

deadpixelremoval
****************


**Syntax:** :code:`deadpixelremoval(image, radius, magnitude)`

Removes dead pixels from projection dataset.Determines whether dead pixel removal algorithm should be applied to the projection images. In the algorithm, each flat-field corrected projection :math:`I` is processed separately. Pixel at position :math:`x` is classified as dead if its value :math:`I(x)` is :math:`NaN` or it satisfies :math:`|I(x) - m(x)| > M * std(|I - m|)`, where :math:`m` is a median filtering of :math:`I` with user-specified radius, :math:`M` is a magnitude parameter, and :math:`std` is standard deviation of whole image. If a pixel is dead, its value is replaced by :math:`m(x)`, otherwise the value is left unchanged.

This command cannot be used in the distributed processing mode. If you need it, please contact the authors.

Arguments
---------

image [input & output]
~~~~~~~~~~~~~~~~~~~~~~

**Data type:** uint8 image, uint16 image, uint32 image, uint64 image, int8 image, int16 image, int32 image, int64 image, float32 image

Image to process.

radius [input]
~~~~~~~~~~~~~~

**Data type:** positive integer

**Default value:** 1

Median filtering radius.

magnitude [input]
~~~~~~~~~~~~~~~~~

**Data type:** real

**Default value:** 10

Magnitude parameter :math:`M`.

See also
--------

:ref:`fbppreprocess`, :ref:`fbp`, :ref:`deadpixelremoval`, :ref:`createfbpfilter`, :ref:`defaultrecsettings`