colour.lightness#

colour.lightness(Y: FloatingOrArrayLike, method: Union[Literal['Abebe 2017', 'CIE 1976', 'Glasser 1958', 'Fairchild 2010', 'Fairchild 2011', 'Wyszecki 1963'], str] = 'CIE 1976', **kwargs: Any) FloatingOrNDArray[source]#

Return the Lightness \(L\) of given luminance \(Y\) using given method.

Parameters:
Returns:

Lightness \(L\).

Return type:

numpy.floating or numpy.ndarray

Notes

Domain

Scale - Reference

Scale - 1

Y

[0, 100]

[0, 1]

Range

Scale - Reference

Scale - 1

L

[0, 100]

[0, 1]

References

[], [CIET14804h], [FW10], [FC11], [GMRS58], [Wikipedia07a], [Wys63], [WS00l]

Examples

>>> lightness(12.19722535)  
41.5278758...
>>> lightness(12.19722535, Y_n=100)  
41.5278758...
>>> lightness(12.19722535, Y_n=95)  
42.5199307...
>>> lightness(12.19722535, method='Glasser 1958')  
39.8351264...
>>> lightness(12.19722535, method='Wyszecki 1963')  
40.5475745...
>>> lightness(12.19722535, epsilon=0.710, method='Fairchild 2011')
... 
29.8295108...
>>> lightness(12.19722535, epsilon=0.710, method='Fairchild 2011')
... 
29.8295108...
>>> lightness(12.19722535, method='Abebe 2017')
... 
48.6955571...