munsellinterpol: RGBtoMunsell – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

RGBtoMunsell

Convert sRGB coordinates to a Munsell specification

Description

RGBtoMunsell Converts RGB coordinates to a Munsell specification, by interpolating over the extrapolated Munsell renotation data

Usage

RGBtoMunsell( RGB, space='sRGB', maxSignal=255, adapt='Bradford', ... )

Arguments

`RGB`	a numeric Nx3 matrix with RGB coordinates in the rows, or a vector that can be converted to such a matrix, by row. These are non-linear display values, but they are not required to be integers.
`space`	the name of an installed RGB space. Spaces `'sRGB'` and `'AdobeRGB'` are pre-installed, and others can be installed with `installRGB()`.
`maxSignal`	maximum value of RGB for display. Other popular values are 1, 1023, and 65535. Even when 1, they are still taken to be non-linear display values.
`adapt`	method for chromatic adaptation, see `CAT()` for valid values. Also see Details.
`...`	other parameters passed to `XYZtoMunsell()`

Details

The conversion is done in 3 steps.

RGB → XYZ using XYZfromRGB() with the given space and maxSignal
XYZ is adapted from the white-point of space to Illuminant C using the given chromatic adaptation method
XYZ → HVC using XYZtoMunsell()

Value

a numeric Nx3 matrix with HVC coordinates in the rows. The rownames are copied from input to output.
In case of error, it returns NULL.

Author(s)

Jose Gama and Glenn Davis

References

Wikipedia. sRGB. https://en.wikipedia.org/wiki/SRGB.

Paul Centore 2014 The Munsell and Kubelka-Munk Toolbox http://centore.isletech.net/~centore/MunsellAndKubelkaMunkToolbox/MunsellAndKubelkaMunkToolbox.html

Examples

RGBtoMunsell( c(255,45,67) )
##                     H        V        C
##  5.4R 5.5/18 5.401135 5.477315 18.01984

RGBtoMunsell( c(255,45,67), space='Adobe' )
##                     H        V        C
##  5.9R 6.2/22 5.924749 6.214155 21.83907

munsellinterpol

Interpolate Munsell Renotation Data from Hue/Chroma to CIE/RGB

v2.6-1

GPL (>= 3)

Authors

Jose Gama [aut, trl], Paul Centore [aut, cph], Glenn Davis [aut, cre]

Initial release

2020-02-02