The munsell package provides easy access to, and manipulation of, the Munsell colours. The munsell package provides a mapping between Munsell’s original notation (e.g. “5R 5/10”) and hexadecimal sRGB strings suitable for use directly in R graphics. The package also provides utilities to explore slices through the Munsell colour tree, to transform Munsell colours and display colour palettes.

Munsell devised his system of colour notation to match the three perceptual dimensions of colour: hue, value and chroma. His notation provides a naming scheme to colours that eases the choice of color according to a specific purpose. His century old advice is still relevant for the producers of statistical graphics and the munsell package aims to enable user to easily follow it.

munsell relies directly on the published tables in Newhall, Nickerson, and Judd (1943) of CIE XYZ (Illuminant C) values for Munsell colours. These tables were the result of colour matching studies on Munsell’s color samples along with some smoothing and extrapolation with Munsell’s goal of perceptually uniform spacing in mind.

Currently the munsell package only includes hue in steps of 2.5, value in steps of 2 and chroma in steps of 1, corresponding directly to the entries in Table 1 in Newhall, Nickerson, and Judd (1943). If you require a more continuous mapping, see munsellinter.

Usage

Functions in munsell fall into three basic use categories: specifying Munsell colours, altering Munsell colours and exploring the Munsell color space.

The code below relies on the development version of munsell, get it with:

devtools::install_github("cwickham/munsell")

Color specification

Following Munsell, specifying colours is done with a specific string format: “H V/C” where H is a hue code (see mnsl_hues() for a list of those available, excluding “N”), V an integer in