colour.lightness#
- colour.lightness(Y: ArrayLike, method: Literal['Abebe 2017', 'CIE 1976', 'Glasser 1958', 'Fairchild 2010', 'Fairchild 2011', 'Wyszecki 1963'] | str = 'CIE 1976', **kwargs: Any) NDArrayFloat[source]#
Return the Lightness \(L\) of given luminance \(Y\) using given method.
- Parameters:
Y (ArrayLike) – Luminance \(Y\).
method (Literal['Abebe 2017', 'CIE 1976', 'Glasser 1958', 'Fairchild 2010', 'Fairchild 2011', 'Wyszecki 1963'] | str) – Computation method.
Y_n – {
colour.colorimetry.lightness_Abebe2017(),colour.colorimetry.lightness_CIE1976()}, White reference luminance \(Y_n\).epsilon – {
colour.colorimetry.lightness_Fairchild2010(),colour.colorimetry.lightness_Fairchild2011()}, \(\epsilon\) exponent.kwargs (Any) –
- Returns:
Lightness \(L\).
- Return type:
Notes
Domain
Scale - Reference
Scale - 1
Y[0, 100]
[0, 1]
Range
Scale - Reference
Scale - 1
L[0, 100]
[0, 1]
References
[APLR17], [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...