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