MunsellToLab: Convert a Munsell specification to CIE Lab coordinates

View source: R/conversions.R

MunsellToLabR Documentation

Convert a Munsell specification to CIE Lab coordinates

Description

MunsellToLab Converts a Munsell specification to CIE Lab coordinates, by interpolating over the extrapolated Munsell renotation data

Usage

MunsellToLab( MunsellSpec, white='D65', adapt='Bradford', ... ) 

Arguments

MunsellSpec

a numeric Nx3 matrix with HVC values in the rows, or a vector that can be converted to such a matrix, by row.
MunsellSpec can also be a character vector with Munsell Notations, which is converted to an Nx3 matrix HVC using HVCfromMunsellName()

white

XYZ for the source white - a numeric 3-vector with scaling irrelevant. white can also be a numeric 2-vector; which is interpreted as xy chromaticity and converted to XYZ with Y=100. white can also be the name of any standard illuminant recognized by spacesXYZ::standardXYZ() which is scaled so that Y=100. The default 'D65' is converted to c(95.047,100,108.883).

adapt

method for chromatic adaptation, see spacesXYZ::CAT() for valid values. Also see Details.

...

other parameters passed to MunsellToXYZ()

Details

The conversion is done in these steps:

  • HVC \rarrow XYZ using MunsellToXYZ()

  • XYZ is adapted from Illuminant C to the given white using spacesXYZ::adaptXYZ() and the given chromatic adaptation method

  • XYZ \rarrow Lab using spacesXYZ::LabfromXYZ() with the given white

Value

An Nx3 matrix with the Lab coordinates in each row. The rownames of Lab are copied from the input HVC matrix, unless the rownames are NULL and then the output rownames are the Munsell notations for HVC.

Author(s)

Jose Gama and Glenn Davis

References

Paul Centore 2014 The Munsell and Kubelka-Munk Toolbox https://www.munsellcolourscienceforpainters.com/MunsellAndKubelkaMunkToolbox/MunsellAndKubelkaMunkToolbox.html

See Also

LabToMunsell(), MunsellToXYZ(), spacesXYZ::LabfromXYZ(), spacesXYZ::standardXYZ(), spacesXYZ::adaptXYZ(), spacesXYZ::CAT()

Examples

MunsellToLab( c('7.6P 8.9/2.2', 'N 5/' ) )
##                      L       a         b
##  7.6P 8.9/2.2 89.19097 5.09879 -3.250468
##  N 5/         51.00375 0.00000  0.000000

munsellinterpol documentation built on April 8, 2022, 9:07 a.m.