Source code for colour.models.deprecated

#!/usr/bin/env python
# -*- coding: utf-8 -*-

"""
Deprecated Colour Models Transformations
========================================

Defines various deprecated colour models transformations:

-   :func:`RGB_to_HSV`
-   :func:`HSV_to_RGB`
-   :func:`RGB_to_HSL`
-   :func:`HSL_to_RGB`
-   :func:`RGB_to_CMY`
-   :func:`CMY_to_RGB`
-   :func:`CMY_to_CMYK`
-   :func:`CMYK_to_CMY`
-   :func:`RGB_to_HEX`
-   :func:`HEX_to_RGB`

These colour models are stated as deprecated because they trade off perceptual
relevance for computation speed. They should not be used in the colour science
domain although they are useful for image analysis and provide end user
software colour selection tools.

They are provided for convenience and completeness.

Warning
-------
Don't use that! Seriously...

References
----------
.. [1]  http://en.wikipedia.org/wiki/HSL_and_HSV
        (Last accessed 10 August 2014)
.. [2]  http://alvyray.com/Papers/CG/color78.pdf
        (Last accessed 10 August 2014)
"""

from __future__ import division, unicode_literals

import math
import numpy as np

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

__all__ = ['RGB_to_HSV',
           'HSV_to_RGB',
           'RGB_to_HSL',
           'HSL_to_RGB',
           'RGB_to_CMY',
           'CMY_to_RGB',
           'CMY_to_CMYK',
           'CMYK_to_CMY',
           'RGB_to_HEX',
           'HEX_to_RGB']


[docs]def RGB_to_HSV(RGB): """ Converts from *RGB* colourspace to *HSV* colourspace. Parameters ---------- RGB : array_like, (3,) *RGB* colourspace matrix. Returns ------- ndarray, (3,) *HSV* matrix. Notes ----- - Input *RGB* colourspace matrix is in domain [0, 1]. - Output *HSV* colourspace matrix is in domain [0, 1]. References ---------- .. [3] http://www.easyrgb.com/index.php?X=MATH&H=20#text20 (Last accessed 18 May 2014) Examples -------- >>> RGB = np.array([0.49019608, 0.98039216, 0.25098039]) >>> RGB_to_HSV(RGB) # doctest: +ELLIPSIS array([ 0.2786738..., 0.744 , 0.98039216]) """ R, G, B = np.ravel(RGB) minimum = min(R, G, B) maximum = max(R, G, B) delta = maximum - minimum V = maximum if delta == 0: H = 0 S = 0 else: S = delta / maximum delta_R = (((maximum - R) / 6) + (delta / 2)) / delta delta_G = (((maximum - G) / 6) + (delta / 2)) / delta delta_B = (((maximum - B) / 6) + (delta / 2)) / delta if R == maximum: H = delta_B - delta_G elif G == maximum: H = (1 / 3) + delta_R - delta_B elif B == maximum: H = (2 / 3) + delta_G - delta_R if H < 0: H += 1 if H > 1: H -= 1 return np.array([H, S, V])
[docs]def HSV_to_RGB(HSV): """ Converts from *HSV* colourspace to *RGB* colourspace. Parameters ---------- HSV : array_like, (3,) *HSV* colourspace matrix. Returns ------- ndarray, (3,) *RGB* colourspace matrix. Notes ----- - Input *HSV* colourspace matrix is in domain [0, 1]. - Output *RGB* colourspace matrix is in domain [0, 1]. References ---------- .. [4] http://www.easyrgb.com/index.php?X=MATH&H=21#text21 (Last accessed 18 May 2014) Examples -------- >>> HSV = np.array([0.27867384, 0.744, 0.98039216]) >>> HSV_to_RGB(HSV) # doctest: +ELLIPSIS array([ 0.4901960..., 0.9803921..., 0.2509803...]) """ H, S, V = np.ravel(HSV) if S == 0: R = V G = V B = V else: h = H * 6 if h == 6: h = 0 i = math.floor(h) j = V * (1 - S) k = V * (1 - S * (h - i)) l = V * (1 - S * (1 - (h - i))) if i == 0: R = V G = l B = j elif i == 1: R = k G = V B = j elif i == 2: R = j G = V B = l elif i == 3: R = j G = k B = V elif i == 4: R = l G = j B = V elif i == 5: R = V G = j B = k return np.array([R, G, B])
[docs]def RGB_to_HSL(RGB): """ Converts from *RGB* colourspace to *HSL* colourspace. Parameters ---------- RGB : array_like, (3,) *RGB* colourspace matrix. Returns ------- ndarray, (3,) *HSL* matrix. Notes ----- - Input *RGB* colourspace matrix is in domain [0, 1]. - Output *HSL* colourspace matrix is in domain [0, 1]. References ---------- .. [5] http://www.easyrgb.com/index.php?X=MATH&H=18#text18 (Last accessed 18 May 2014) Examples -------- >>> RGB = np.array([0.49019608, 0.98039216, 0.25098039]) >>> RGB_to_HSL(RGB) # doctest: +ELLIPSIS array([ 0.2786738..., 0.9489796..., 0.6156862...]) """ R, G, B = np.ravel(RGB) minimum = min(R, G, B) maximum = max(R, G, B) delta = maximum - minimum L = (maximum + minimum) / 2 if delta == 0: H = 0 S = 0 else: S = delta / (maximum + minimum) if L < 0.5 else delta / ( 2 - maximum - minimum) delta_R = (((maximum - R) / 6) + (delta / 2)) / delta delta_G = (((maximum - G) / 6) + (delta / 2)) / delta delta_B = (((maximum - B) / 6) + (delta / 2)) / delta if R == maximum: H = delta_B - delta_G elif G == maximum: H = (1 / 3) + delta_R - delta_B elif B == maximum: H = (2 / 3) + delta_G - delta_R if H < 0: H += 1 if H > 1: H -= 1 return np.array([H, S, L])
[docs]def HSL_to_RGB(HSL): """ Converts from *HSL* colourspace to *RGB* colourspace. Parameters ---------- HSL : array_like, (3,) *HSL* colourspace matrix. Returns ------- ndarray, (3,) *RGB* colourspace matrix. Notes ----- - Input *HSL* colourspace matrix is in domain [0, 1]. - Output *RGB* colourspace matrix is in domain [0, 1]. References ---------- .. [6] http://www.easyrgb.com/index.php?X=MATH&H=19#text19 (Last accessed 18 May 2014) Examples -------- >>> HSL = np.array([0.27867384, 0.94897959, 0.61568627]) >>> HSL_to_RGB(HSL) # doctest: +ELLIPSIS array([ 0.4901960..., 0.9803921..., 0.2509803...]) """ H, S, L = np.ravel(HSL) if S == 1: R = L G = L B = L else: def H_to_RGB(vi, vj, vH): """ Converts *hue* value to *RGB* colourspace. """ if vH < 0: vH += 1 if vH > 1: vH -= 1 if 6 * vH < 1: return vi + (vj - vi) * 6 * vH if 2 * vH < 1: return vj if 3 * vH < 2: return vi + (vj - vi) * ((2 / 3) - vH) * 6 return vi j = L * (1 + S) if L < 0.5 else (L + S) - (S * L) i = 2 * L - j R = H_to_RGB(i, j, H + (1 / 3)) G = H_to_RGB(i, j, H) B = H_to_RGB(i, j, H - (1 / 3)) return np.array([R, G, B])
[docs]def RGB_to_CMY(RGB): """ Converts from *RGB* colourspace to *CMY* colourspace. Parameters ---------- RGB : array_like, (3,) *RGB* colourspace matrix. Returns ------- ndarray, (3,) *CMY* matrix. Notes ----- - Input *RGB* colourspace matrix is in domain [0, 1]. - Output *CMY* colourspace matrix is in domain [0, 1]. References ---------- .. [7] http://www.easyrgb.com/index.php?X=MATH&H=11#text11 (Last accessed 18 May 2014) Examples -------- >>> RGB = np.array([0.49019608, 0.98039216, 0.25098039]) >>> RGB_to_CMY(RGB) # doctest: +ELLIPSIS array([ 0.5098039..., 0.0196078..., 0.7490196...]) """ R, G, B = np.ravel(RGB) return np.array([1 - R, 1 - G, 1 - B])
[docs]def CMY_to_RGB(CMY): """ Converts from *CMY* colourspace to *CMY* colourspace. Parameters ---------- CMY : array_like, (3,) *CMY* colourspace matrix. Returns ------- ndarray, (3,) *RGB* colourspace matrix. Notes ----- - Input *CMY* colourspace matrix is in domain [0, 1]. - Output *RGB* colourspace matrix is in domain [0, 1]. References ---------- .. [8] http://www.easyrgb.com/index.php?X=MATH&H=12#text12 (Last accessed 18 May 2014) Examples -------- >>> CMY = np.array([0.50980392, 0.01960784, 0.74901961]) >>> CMY_to_RGB(CMY) # doctest: +ELLIPSIS array([ 0.4901960..., 0.9803921..., 0.2509803...]) """ C, M, Y = np.ravel(CMY) return np.array([1 - C, 1 - M, 1 - Y])
[docs]def CMY_to_CMYK(CMY): """ Converts from *CMY* colourspace to *CMYK* colourspace. Parameters ---------- CMY : array_like, (3,) *CMY* colourspace matrix. Returns ------- ndarray, (4,) *CMYK* matrix. Notes ----- - Input *CMY* colourspace matrix is in domain [0, 1]. - Output*CMYK* colourspace matrix is in domain [0, 1]. References ---------- .. [9] http://www.easyrgb.com/index.php?X=MATH&H=13#text13 (Last accessed 18 May 2014) Examples -------- >>> CMY = np.array([0.50980392, 0.01960784, 0.74901961]) >>> CMY_to_CMYK(CMY) # doctest: +ELLIPSIS array([ 0.5 , 0. , 0.744 , 0.0196078...]) """ C, M, Y = np.ravel(CMY) K = 1 if C < K: K = C if M < K: K = M if Y < K: K = Y if K == 1: C = 0 M = 0 Y = 0 else: C = (C - K) / (1 - K) M = (M - K) / (1 - K) Y = (Y - K) / (1 - K) return np.array([C, M, Y, K])
[docs]def CMYK_to_CMY(CMYK): """ Converts from *CMYK* colourspace to *CMY* colourspace. Parameters ---------- CMYK : array_like, (4,) *CMYK* colourspace matrix. Returns ------- ndarray, (3,) *CMY* matrix. Notes ----- - Input *CMYK* colourspace matrix is in domain [0, 1]. - Output *CMY* colourspace matrix is in domain [0, 1]. References ---------- .. [10] http://www.easyrgb.com/index.php?X=MATH&H=14#text14 Examples -------- >>> CMYK = np.array([0.5, 0, 0.744, 0.01960784]) >>> CMYK_to_CMY(CMYK) # doctest: +ELLIPSIS array([ 0.5098039..., 0.0196078..., 0.7490196...]) """ C, M, Y, K = np.ravel(CMYK) return np.array( [C * (1 - K) + K, M * (1 - K) + K, Y * (1 - K) + K])
[docs]def RGB_to_HEX(RGB): """ Converts from *RGB* colourspace to hex triplet representation. Parameters ---------- RGB : array_like, (3,) *RGB* colourspace matrix. Returns ------- unicode Hex triplet representation. Notes ----- - Input *RGB* colourspace matrix is in domain [0, 1]. Examples -------- >>> RGB = np.array([0.66666667, 0.86666667, 1]) >>> # Doctests skip for Python 2.x compatibility. >>> RGB_to_HEX(RGB) # doctest: +SKIP '#aaddff' """ RGB = np.ravel(RGB) R, G, B = map(int, RGB * 255) return '#{0:02x}{1:02x}{2:02x}'.format(R, G, B)
[docs]def HEX_to_RGB(HEX): """ Converts from hex triplet representation to *RGB* colourspace. Parameters ---------- HEX : unicode Hex triplet representation. Returns ------- ndarray, (3,) *RGB* colourspace matrix. Notes ----- - Output *RGB* colourspace matrix is in domain [0, 1]. Examples -------- >>> HEX = '#aaddff' >>> HEX_to_RGB(HEX) # doctest: +ELLIPSIS array([ 0.6666666..., 0.8666666..., 1. ]) """ HEX = HEX.lstrip('#') length = len(HEX) return np.array([int(HEX[i:i + length // 3], 16) for i in range(0, length, length // 3)]) / 255