colour.models.common Module

Common Colour Models Utilities

Defines various colour models common utilities.

colour.models.common.COLOURSPACE_MODELS_LABELS = {'CIE XYZ': ('X', 'Y', 'Z'), 'CIE xyY': ('x', 'y', 'Y'), 'CIE Lab': ('$a^*$', '$b^*$', '$L^*$'), 'CIE LCHab': ('CH', 'ab', '$L^*$'), 'CIE Luv': ('$u^\\prime$', '$v^\\prime$', '$L^*$'), 'CIE Luv uv': ('$u^\\prime$', '$v^\\prime$'), 'CIE LCHuv': ('CH', 'uv', '$L^*$'), 'CIE UCS': ('U', 'V', 'W'), 'CIE UCS uv': ('$u$', '$v$'), 'CIE UVW': ('U', 'V', 'W'), 'IPT': ('P', 'T', 'I'), 'Hunter Lab': ('$a^*$', '$b^*$', '$L^*$'), 'Hunter Rdab': ('$a$', '$b$', '$Rd$')}

Colourspace models labels mapping.

COLOURSPACE_MODELS_LABELS : dict
{‘CIE XYZ’, ‘CIE xyY’, ‘CIE Lab’, ‘CIE LCHab, ‘CIE Luv’, ‘CIE Luv uv’, ‘CIE LCHuv’, ‘CIE UCS’, ‘CIE UCS uv’, ‘CIE UVW’, ‘IPT’, ‘Hunter Lab’, ‘Hunter Rdab’}
colour.models.common.XYZ_to_colourspace_model(XYZ, illuminant, model)[source]

Converts from CIE XYZ tristimulus values to given colourspace model.

Parameters:
  • XYZ (array_like) – CIE XYZ tristimulus values.
  • illuminant (array_like) – CIE XYZ tristimulus values illuminant xy chromaticity coordinates.
  • model (unicode) – {‘CIE XYZ’, ‘CIE xyY’, ‘CIE xy’, ‘CIE Lab’, ‘CIE LCHab’, ‘CIE Luv’, ‘CIE Luv uv’, ‘CIE LCHuv’, ‘CIE UCS’, ‘CIE UCS uv’, ‘CIE UVW’, ‘IPT’, ‘Hunter Lab’, ‘Hunter Rdab’}, Colourspace model to convert the CIE XYZ tristimulus values to.
Returns:

Colourspace model values.

Return type:

ndarray

Examples

>>> import numpy as np
>>> XYZ = np.array([0.07049534, 0.10080000, 0.09558313])
>>> W = np.array([0.34570, 0.35850])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'CIE XYZ')
array([ 0.0704953...,  0.1008    ,  0.0955831...])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'CIE xyY')
array([ 0.2641477...,  0.3777000...,  0.1008    ])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'CIE xy')
array([ 0.2641477...,  0.3777000...])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'CIE Lab')
array([ 37.9856291..., -23.6290768...,  -4.4174661...])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'CIE LCHab')
array([  37.9856291...,   24.0384542...,  190.5892337...])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'CIE Luv')
array([ 37.9856291..., -28.8021959...,  -1.3580070...])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'CIE Luv uv')
array([ 0.1508531...,  0.4853297...])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'CIE LCHuv')
array([  37.9856291...,   28.8341927...,  182.6994640...])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'CIE UCS uv')
array([ 0.1508531...,  0.32355314...])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'CIE UVW')
array([-28.0579733...,  -0.8819449...,  37.0041149...])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'IPT')
array([ 0.3657112..., -0.1111479...,  0.0159474...])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'Hunter Lab')
array([ 31.7490157..., -15.1351736...,  -2.7709606...])
>>> XYZ_to_colourspace_model(  
... XYZ, W, 'Hunter Rdab')
array([ 10.08..., -18.7019271...,  -3.4239649...])