.. _`Color space conversion`:

.. _`syip.color_space_conversion`:

Color space conversion
~~~~~~~~~~~~~~~~~~~~~~

.. image:: image_colorspace.svg
   :width: 48


Converts each pixel in a multi-channel image into another colour space

*Algorithms*:


  - `grey2cmap`_

    Converts greyscale values after normalization and scaling from 0 - 255 into a matplotlib colourmap.

    **cmap:**
      The colormap to use in conversion


  - *greyscale*

    Transforms RGB images into greyscale

    **luminance preserving:**
      Use weighted average based on separate luminosity of red-green-blue receptors in human eye.

      Only works for three channel images


  - `hsv2rgb`_

    Interprets input channels as Hue-Saturation-Value (HSV) and outputs Red-Green-Blue (RGB) channels.


  - `lab2rgb`_

    Interprets input channels as sRGB and outputs CIE LAB channels.

    **illuminant:**
      CIE standard illumination spectrum

    **observer:**
      Aperture angle of observer


  - `rgb2hsv`_

    Interprets input channels as Red-Green-Blue (RGB) and outputs Hue-Saturation-Value (HSV) channels.


  - `rgb2lab`_

    Interprets input channels as sRGB and outputs CIE LAB channels.

    **illuminant:**
      CIE standard illumination spectrum

    **observer:**
      Aperture angle of observer


  - `rgb2xyz`_

    Interprets input channels as sRGB and outputs CIE XYZ channels.


  - `xyz2rgb`_

    Interprets input channels as CIE XYZ and outputs sRGB channels.


.. _grey2cmap: https://matplotlib.org/examples/color/colormaps_reference.html
.. _hsv2rgb: http://scikit-image.org/docs/0.13.x/api/skimage.color.html#skimage.color.hsv2rgb
.. _lab2rgb: http://scikit-image.org/docs/0.13.x/api/skimage.color.html#skimage.color.rgb2lab
.. _rgb2hsv: http://scikit-image.org/docs/0.13.x/api/skimage.color.html#skimage.color.rgb2hsv
.. _rgb2lab: http://scikit-image.org/docs/0.13.x/api/skimage.color.html#skimage.color.rgb2lab
.. _rgb2xyz: http://scikit-image.org/docs/0.13.x/api/skimage.color.html#skimage.color.rgb2xyz
.. _xyz2rgb: http://scikit-image.org/docs/0.13.x/api/skimage.color.html#skimage.color.xyz2rgb

*Input ports*:
    **source** : image

        source image to filter

*Output ports*:
    **result** : image

        result after filtering



*Configuration*:
    **Algorithm** (algorithm)
        (no description)
    **cmap** (cmap)
        (no description)
    **illuminant** (illuminant)
        (no description)
    **observer** (observer)
        (no description)
    **luminance preserving** (luminance preserving)
        (no description)

.. automodule:: node_colors

.. class:: ColorSpaceConversion