plotPatchesH: Plot Colored Patches for a fixed Munsell Hue

In munsellinterpol: Interpolate Munsell Renotation Data from Hue Value/Chroma to CIE/RGB

Plot Colored Patches for a fixed Munsell Hue

Description

This plot simulates a page from the Munsell Book of Color. The colors are best viewed on a display calibrated for the RGB space given as the second argument.

Usage

plotPatchesH( hue, space='sRGB', adapt='Bradford', background='gray50',
                        main="Hue %s  (H=%g)      [%s   adapt=%s]",
                        value=NULL, chroma=NULL, ... ) 

Arguments

hue	a Munsell hue for which the plot is created. It is automatically wrapped to the interval (0,100]. It does not have to be a multiple of 2.5. hue can also be a numeric vector of such numbers, and then a separate plot is made for each element of the vector. hue can also be a character vector of Hue Names, which is then converted to a numeric vector using HueNumberFromString().
space	the name of an installed RGB space. Spaces 'sRGB' and 'AdobeRGB' are pre-installed, and others can be installed using spacesRGB::installRGB()
adapt	method used to adapt xyY for Illuminant C to xyY for Illuminant D65. It is passed to MunsellToRGB().
background	background color for the plot. It is passed to par() as argument bg.
main	a string used to set the main title of the plot. The optional placeholder '%s' is replaced by the Hue Name, '%g' is replaced by the Hue Number, the next '%s' is replaced by space, and the last '%s' is replaced by adapt.
value	a vector of Munsell Values to use for the plot. Values must be in the interval [0,10], and in strictly increasing order. Non-integers, such as 2.5 and 8.5, are valid. If value=NULL, then it is set to 0:10.
chroma	a vector of Munsell Chromas to use for the plot. Chromas must be non-negative and in strictly increasing order. Odd integers and non-integers are valid. If chroma=NULL, then a sequence of even numbers is chosen, starting at 0 and ending at the Chroma limit for the given Hue page, see Details.
...	other arguments passed to the function MunsellToRGB(). This includes hcinterp, vinterp, and xyC.

Details

If chroma=NULL, for the closest discrete Hue in real.dat, the patches in real.dat are transformed to xyY using simple lookup with no interpolation. These are then tested against the MacAdam Limits for Illuminant C using IsWithinMacAdamLimits(). The patches outside the limits are discarded, and the maximum Chroma of the remaining patches, which is always an even integer, determines chroma.
Patches inside the MacAdam Limits can still be outside the RGB cube; those patches are drawn in outline only, and with the clamped RGB coordinates printed inside.

Value

TRUE for success and FALSE for failure.

Author(s)

Glenn Davis

See Also

MunsellToRGB(), HueNumberFromString(), IsWithinMacAdamLimits(), spacesRGB::installRGB()

munsellinterpol documentation built on June 18, 2025, 9:08 a.m.