colour.JMh_CIECAM02_to_CAM02UCS#

colour.JMh_CIECAM02_to_CAM02UCS(JMh: ArrayLike) NDArrayFloat[source]#

Convert from CIECAM02 \(JMh\) correlates array to Luo et al. (2006) CAM02-UCS colourspace \(J'a'b'\) array.

Parameters:

JMh (ArrayLike) – CIECAM02 correlates array \(JMh\).

Returns:

Luo et al. (2006) CAM02-UCS colourspace \(J'a'b'\) array.

Return type:

numpy.ndarray

Notes

  • UCS in CAM02-UCS stands for Uniform Colour Colourspace.

Domain

Scale - Reference

Scale - 1

JMh

J : [0, 100]

M : [0, 100]

h : [0, 360]

J : [0, 1]

M : [0, 1]

h : [0, 1]

Range

Scale - Reference

Scale - 1

Jpapbp

Jp : [0, 100]

ap : [-100, 100]

bp : [-100, 100]

Jp : [0, 1]

ap : [-1, 1]

bp : [-1, 1]

References

[LCL06]

Examples

>>> from colour.appearance import (
...     VIEWING_CONDITIONS_CIECAM02,
...     XYZ_to_CIECAM02,
... )
>>> XYZ = np.array([19.01, 20.00, 21.78])
>>> XYZ_w = np.array([95.05, 100.00, 108.88])
>>> L_A = 318.31
>>> Y_b = 20.0
>>> surround = VIEWING_CONDITIONS_CIECAM02["Average"]
>>> specification = XYZ_to_CIECAM02(XYZ, XYZ_w, L_A, Y_b, surround)
>>> JMh = (specification.J, specification.M, specification.h)
>>> JMh_CIECAM02_to_CAM02UCS(JMh)  
array([ 54.9043313...,  -0.0844236...,  -0.0684831...])