colour.XYZ_to_CAM02UCS#

colour.XYZ_to_CAM02UCS(XYZ: ArrayLike, **kwargs: Any) NDArrayFloat[source]#

Convert from CIE XYZ tristimulus values to Luo et al. (2006) CAM02-UCS colourspace \(J'a'b'\) array.

Parameters:
  • XYZ (ArrayLike) – CIE XYZ tristimulus values.

  • kwargs (Any) – {colour.XYZ_to_CIECAM02()}, See the documentation of the previously listed definition. The default viewing conditions are that of IEC 61966-2-1:1999, i.e. sRGB 64 Lux ambient illumination, 80 \(cd/m^2\), adapting field luminance about 20% of a white object in the scene.

Returns:

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

Return type:

numpy.ndarray

Warning

The XYZ_w parameter for colour.XYZ_to_CAM16() definition must be given in the same domain-range scale than the XYZ parameter.

Notes

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

Domain

Scale - Reference

Scale - 1

XYZ

[0, 1]

[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

>>> XYZ = np.array([0.20654008, 0.12197225, 0.05136952])
>>> XYZ_to_CAM02UCS(XYZ)  
array([ 46.6138615...,  29.8831001...,  12.1235168...])