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