Coverage for notation/datasets/munsell/__init__.py: 0%

1from colour.utilities import CanonicalMapping 

2 

3from .all import MUNSELL_COLOURS_ALL 

4from .experimental import MUNSELL_COLOURS_1929 

5from .real import MUNSELL_COLOURS_REAL 

6 

7__all__ = [ 

8 "MUNSELL_COLOURS_ALL", 

9] 

10__all__ += [ 

11 "MUNSELL_COLOURS_1929", 

12] 

13__all__ += [ 

14 "MUNSELL_COLOURS_REAL", 

15] 

16 

17MUNSELL_COLOURS = CanonicalMapping( 

18 { 

19 "Munsell Colours All": MUNSELL_COLOURS_ALL, 

20 "Munsell Colours 1929": MUNSELL_COLOURS_1929, 

21 "Munsell Colours Real": MUNSELL_COLOURS_REAL, 

22 } 

23) 

24MUNSELL_COLOURS.__doc__ = """ 

25Define the *Munsell Renotation System* datasets. 

26 

27- ``Munsell Colours All``: *all* published *Munsell* colours, including the 

28 extrapolated colors. 

29- ``Munsell Colours 1929``: the colours appearing in the 1929 

30 *Munsell Book of Color*. These data has been used in the scaling 

31 experiments leading to the 1943 renotation. 

32- ``Munsell Colours Real``: *real*, within MacAdam limits *Munsell* colours 

33 only. They are the colours listed in the original 1943 renotation article 

34 *(Newhall, Nickerson, & Judd, 1943)*. 

35 

36Notes 

37----- 

38- The Munsell Renotation data commonly available within the *all.dat*, 

39 *experimental.dat* and *real.dat* files features *CIE xyY* colourspace 

40 values that are scaled by a :math:`1 / 0.975 \\simeq 1.02568` factor. If 

41 you are performing conversions using *Munsell* *Colorlab* specification, 

42 e.g., *2.5R 9/2*, according to *ASTM D1535-08e1* method, you should not 

43 scale the output :math:`Y` Luminance. However, if you use directly the 

44 *CIE xyY* colourspace values from the Munsell Renotation data, you should 

45 scale the :math:`Y` Luminance before conversions by a :math:`0.975` factor. 

46 

47 *ASTM D1535-08e1* states that:: 

48 

49 The coefficients of this equation are obtained from the 1943 equation 

50 by multiplying each coefficient by 0.975, the reflectance factor of 

51 magnesium oxide with respect to the perfect reflecting diffuser, and 

52 rounding to ve digits of precision. 

53 

54- Chromaticities assume *CIE Illuminant C*, approximately 6700K, as neutral 

55 origin for both the hue and chroma loci. 

56 

57References 

58---------- 

59- :cite:`MunsellColorSciencec` : Munsell Color Science. (n.d.). Munsell 

60 Colours Data. Retrieved August 20, 2014, from 

61 http://www.cis.rit.edu/research/mcsl2/online/munsell.php 

62 

63Aliases: 

64 

65- 'all': 'Munsell Colours All' 

66- '1929': 'Munsell Colours 1929' 

67- 'real': 'Munsell Colours Real' 

68""" 

69MUNSELL_COLOURS["all"] = MUNSELL_COLOURS["Munsell Colours All"] 

70MUNSELL_COLOURS["1929"] = MUNSELL_COLOURS["Munsell Colours 1929"] 

71MUNSELL_COLOURS["real"] = MUNSELL_COLOURS["Munsell Colours Real"] 

72 

73__all__ += [ 

74 "MUNSELL_COLOURS", 

75]