colour.munsell_value

colour.munsell_value(Y: FloatingOrArrayLike, method: Union[Literal['ASTM D1535', 'Ladd 1955', 'McCamy 1987', 'Moon 1943', 'Munsell 1933', 'Priest 1920', 'Saunderson 1944'], str] = 'ASTM D1535') FloatingOrNDArray[source]

Return the Munsell value \(V\) of given luminance \(Y\) using given method.

Parameters
  • Y (FloatingOrArrayLike) – luminance \(Y\).

  • method (Union[Literal['ASTM D1535', 'Ladd 1955', 'McCamy 1987', 'Moon 1943', 'Munsell 1933', 'Priest 1920', 'Saunderson 1944'], str]) – Computation method.

Returns

Munsell value \(V\).

Return type

np.floating or numpy.ndarray

Notes

Domain

Scale - Reference

Scale - 1

Y

[0, 100]

[0, 1]

Range

Scale - Reference

Scale - 1

V

[0, 10]

[0, 1]

References

[ASTMInternational89], [Wikipedia07d]

Examples

>>> munsell_value(12.23634268)  
4.0824437...
>>> munsell_value(12.23634268, method='Priest 1920') 
3.4980484...
>>> munsell_value(12.23634268, method='Munsell 1933') 
4.1627702...
>>> munsell_value(12.23634268, method='Moon 1943') 
4.0688120...
>>> munsell_value(12.23634268, method='Saunderson 1944')
... 
4.0444736...
>>> munsell_value(12.23634268, method='Ladd 1955') 
4.0511633...
>>> munsell_value(12.23634268, method='McCamy 1987') 
4.0814348...