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