colour.XYZ_to_CAM16UCS

colour.XYZ_to_CAM16UCS(XYZ, *, coefficients=Coefficients_UCS_Luo2006(K_L=1.0, c_1=0.007, c_2=0.0228), **kwargs)

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

Parameters

XYZ (array_like) – CIE XYZ tristimulus values.

Other Parameters

**kwargs (dict, optional) – {colour.XYZ_to_CAM16()}, Please refer to the documentation of the previously listed definition. The default viewing conditions are that of IEC 61966-2-1:1999, i.e. sRGB 64 Lux ambiant illumination, 80 \(cd/m^2\), adapting field luminance about 20% of a white object in the scene.

Returns

Li et al. (2017) CAM16-UCS colourspace \(J'a'b'\) array.

Return type

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]