colour.uv_to_Luv#

colour.uv_to_Luv(uv: ArrayLike, illuminant: ArrayLike = CCS_ILLUMINANTS['CIE 1931 2 Degree Standard Observer']['D65'], L: NDArrayFloat = np.array(100)) → 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.
L (NDArrayFloat) – 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`	`L` : [0, 100] `u` : [-100, 100] `v` : [-100, 100]	`L` : [0, 1] `u` : [-1, 1] `v` : [-1, 1]
`illuminant`	[0, 1]	[0, 1]

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]

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...])