colour.models.common Module

Common Colour Models Utilities

Defines various colour models common utilities.

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

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...])