colour.XYZ_to_CAM16UCS#

colour.XYZ_to_CAM16UCS(XYZ: ArrayLike, *, coefficients: ArrayLike = Coefficients_UCS_Luo2006(K_L=1.0, c_1=0.007, c_2=0.0228), **kwargs: Any) → NDArray#

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]

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]