colour.XYZ_to_xyY

colour.XYZ_to_xyY(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]], 1]

Convert from CIE XYZ tristimulus values to CIE xyY colourspace.

Parameters:

XYZ (Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 1]) – CIE XYZ tristimulus values.

Returns:

CIE xyY colourspace array with chromaticity coordinates \(x, y\) and luminance \(Y\).

Return type:

numpy.ndarray

Notes

Domain	Scale - Reference	Scale - 1
XYZ	1	1

Range	Scale - Reference	Scale - 1
xyY	1	1

References

[CIET14804f], [Wikipedia05d]

Examples

>>> XYZ = np.array([0.20654008, 0.12197225, 0.05136952])
>>> XYZ_to_xyY(XYZ)
array([ 0.5436955...,  0.3210794...,  0.1219722...])