colour.uv_to_Luv#

colour.uv_to_Luv(uv: ArrayLike, illuminant: ArrayLike = CCS_ILLUMINANTS['CIE 1931 2 Degree Standard Observer']['D65'], Y: float = 1) NDArrayFloat[source]#

Return the CIE L*u*v* colourspace array from given \(uv^p\) chromaticity coordinates by extending the array last dimension with given \(L\) Lightness.

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

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

  • Y (float) – Optional \(Y\) luminance value used to construct the intermediate CIE XYZ colourspace array, the default \(Y\) luminance value is 1.

Returns:

CIE L*u*v* colourspace array.

Return type:

numpy.ndarray

Notes

Range

Scale - Reference

Scale - 1

Luv

L : [0, 100]

u : [-100, 100]

v : [-100, 100]

L : [0, 1]

u : [-1, 1]

v : [-1, 1]

illuminant

[0, 1]

[0, 1]

References

[CIET14804g]

Examples

>>> import numpy as np
>>> uv = np.array([0.37720213, 0.50120264])
>>> uv_to_Luv(uv)  
array([ 100.        ,  233.1837603...,   42.7474385...])