.. _`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.


  - `rgb2hsv`_

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


  - `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
.. _rgb2hsv: http://scikit-image.org/docs/0.13.x/api/skimage.color.html#skimage.color.rgb2hsv
.. _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

:Inputs:
    **source** : image

        source image to filter

:Outputs:
    **result** : image

        result after filtering

*Ports*:

    **Inputs**:

        :source: image

            source image to filter

    **Outputs**:

        :result: image

            result after filtering

*Configuration*:

    **algorithm**
        (no description)
    **cmap**
        (no description)
    **luminance preserving**
        (no description)

.. automodule:: node_colors

.. class:: ColorSpaceConversion