Source code for colour.models.rgb.prismatic

# -*- coding: utf-8 -*-
"""
Prismatic Colourspace
=====================

Defines the *Prismatic* colourspace transformations:

-   :func:`colour.RGB_to_Prismatic`
-   :func:`colour.Prismatic_to_RGB`

See Also
--------
`Prismatic Colourspace Jupyter Notebook
<http://nbviewer.jupyter.org/github/colour-science/colour-notebooks/\
blob/master/notebooks/models/prismatic.ipynb>`_

References
----------
-   :cite:`Shirley2015a` : Shirley, P., & Hart, D. (2015). The prismatic color
    space for rgb computations.
"""

from __future__ import division, unicode_literals

import numpy as np

from colour.utilities import from_range_1, to_domain_1, tsplit, tstack

__author__ = 'Colour Developers'
__copyright__ = 'Copyright (C) 2013-2019 - Colour Developers'
__license__ = 'New BSD License - https://opensource.org/licenses/BSD-3-Clause'
__maintainer__ = 'Colour Developers'
__email__ = 'colour-science@googlegroups.com'
__status__ = 'Production'

__all__ = ['RGB_to_Prismatic', 'Prismatic_to_RGB']


[docs]def RGB_to_Prismatic(RGB): """ Converts from *RGB* colourspace to *Prismatic* :math:`L\\rho\\gamma\\beta` colourspace array. Parameters ---------- RGB : array_like *RGB* colourspace array. Returns ------- ndarray *Prismatic* :math:`L\\rho\\gamma\\beta` colourspace array. Notes ----- +------------+-----------------------+---------------+ | **Domain** | **Scale - Reference** | **Scale - 1** | +============+=======================+===============+ | ``RGB`` | [0, 1] | [0, 1] | +------------+-----------------------+---------------+ +------------+-----------------------+---------------+ | **Range** | **Scale - Reference** | **Scale - 1** | +============+=======================+===============+ | ``Lrgb`` | [0, 1] | [0, 1] | +------------+-----------------------+---------------+ References ---------- :cite:`Shirley2015a` Examples -------- >>> RGB = np.array([0.25, 0.50, 0.75]) >>> RGB_to_Prismatic(RGB) # doctest: +ELLIPSIS array([ 0.75... , 0.1666666..., 0.3333333..., 0.5... ]) Adjusting saturation of given *RGB* colourspace array: >>> saturation = 0.5 >>> Lrgb = RGB_to_Prismatic(RGB) >>> Lrgb[..., 1:] = 1 / 3 + saturation * (Lrgb[..., 1:] - 1 / 3) >>> Prismatic_to_RGB(Lrgb) # doctest: +ELLIPSIS array([ 0.45..., 0.6..., 0.75...]) """ RGB = to_domain_1(RGB) L = np.max(RGB, axis=-1) s = np.sum(RGB, axis=-1)[..., np.newaxis] one_s = 1 / s # Handling zero-division *NaNs*. one_s[s == 0] = 0 r, g, b = tsplit(one_s * RGB) Lrgb = tstack([L, r, g, b]) return from_range_1(Lrgb)
[docs]def Prismatic_to_RGB(Lrgb): """ Converts from *Prismatic* :math:`L\\rho\\gamma\\beta` colourspace array to *RGB* colourspace. Parameters ---------- Lrgb : array_like *Prismatic* :math:`L\\rho\\gamma\\beta` colourspace array. Returns ------- ndarray *RGB* colourspace array. Notes ----- +------------+-----------------------+---------------+ | **Domain** | **Scale - Reference** | **Scale - 1** | +============+=======================+===============+ | ``Lrgb`` | [0, 1] | [0, 1] | +------------+-----------------------+---------------+ +------------+-----------------------+---------------+ | **Range** | **Scale - Reference** | **Scale - 1** | +============+=======================+===============+ | ``RGB`` | [0, 1] | [0, 1] | +------------+-----------------------+---------------+ References ---------- :cite:`Shirley2015a` Examples -------- >>> Lrgb = np.array([0.75000000, 0.16666667, 0.33333333, 0.50000000]) >>> Prismatic_to_RGB(Lrgb) # doctest: +ELLIPSIS array([ 0.25... , 0.4999999..., 0.75... ]) """ Lrgb = to_domain_1(Lrgb) rgb = Lrgb[..., 1:] m = np.max(rgb, axis=-1)[..., np.newaxis] RGB = Lrgb[..., 0][..., np.newaxis] / m # Handling zero-division *NaNs*. RGB[m == 0] = 0 RGB = RGB * rgb return from_range_1(RGB)