colour.XYZ_to_CAM16UCS#

colour.XYZ_to_CAM16UCS(XYZ: ArrayLike, *, coefficients: ArrayLike = (1.0, 0.007, 0.0228), **kwargs: Any) → NDArrayFloat#

Convert from CIE XYZ tristimulus values to Li et al. (2017) CAM16-UCS colourspace \(J'a'b'\) array.

Parameters:

  • XYZ (ArrayLike) – CIE XYZ tristimulus values.

  • kwargs (Any) – {colour.XYZ_to_CAM16()}, 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.

  • coefficients (ArrayLike) –

Returns:

Li et al. (2017) CAM16-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 CAM16-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

[LLW+17]