colour.uv_to_Luv#

colour.uv_to_Luv(uv: ArrayLike, illuminant: ArrayLike = CCS_ILLUMINANTS['CIE 1931 2 Degree Standard Observer']['D65'], L: Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100] | None = None) Annotated[ndarray[tuple[Any, ...], dtype[float16 | float32 | float64]], 100][source]#

Convert from \(uv^p\) chromaticity coordinates to CIE L*u*v* colourspace by extending the array’s last dimension with the specified \(L^*\) Lightness.

Parameters:
  • uv (ArrayLike) – \(uv^p\) chromaticity coordinates.

  • illuminant (ArrayLike) – Reference illuminant CIE xy chromaticity coordinates or CIE xyY colourspace array.

  • L (Annotated[_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str], 100] | None) – Optional \(L^*\) Lightness value used to construct the intermediate CIE XYZ colourspace array, the default \(L^*\) Lightness value is 100.

Returns:

CIE L*u*v* colourspace array.

Return type:

numpy.ndarray

Notes

Range

Scale - Reference

Scale - 1

Luv

100

1

illuminant

100

1

References

[CIET14804g]

Examples

>>> import numpy as np
>>> uv = np.array([0.37720213, 0.50120264])
>>> uv_to_Luv(uv, L=41.5278752)
array([ 41.5278752...,  96.8362609...,  17.7521029...])