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

1 from colour.utilities import CanonicalMapping

2

3 from .all import MUNSELL_COLOURS_ALL

4 from .experimental import MUNSELL_COLOURS_1929

5 from .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

17 MUNSELL_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)

24 MUNSELL_COLOURS.__doc__ = """

25 Define 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

36 Notes

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

57 References

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

63 Aliases:

64

65- 'all': 'Munsell Colours All'

66- '1929': 'Munsell Colours 1929'

67- 'real': 'Munsell Colours Real'

68"""

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

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

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

72

73 __all__ += [

74 "MUNSELL_COLOURS",

75]