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:
Warning
The
XYZ_w
parameter forcolour.XYZ_to_CAM16()
definition must be given in the same domain-range scale than theXYZ
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]