colour.XYZ_to_sUCS

colour.XYZ_to_sUCS(XYZ: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 1]) → Annotated[ndarray[tuple[Any, ...], dtype[float16 | float32 | float64]], 100]

Convert from CIE XYZ tristimulus values to sUCS colourspace.

Parameters:

XYZ (Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 1]) – CIE XYZ tristimulus values, adapted to CIE Standard Illuminant D65 and in domain [0, 1] (where white \(Y\) is 1.0).

Returns:

sUCS \(Iab\) colourspace array.

Return type:

numpy.ndarray

Notes

Domain	Scale - Reference	Scale - 1
XYZ	1	1

Range	Scale - Reference	Scale - 1
Iab	100	1

• Input CIE XYZ tristimulus values must be adapted to CIE Standard Illuminant D Series D65.

References

[LL24]

Examples

>>> XYZ = np.array([0.20654008, 0.12197225, 0.05136952])
>>> XYZ_to_sUCS(XYZ)
array([ 42.6292365...,  36.9764683...,  14.1230135...])