munsellinterpol (version 3.0-0)

MunsellToLuv: Convert a Munsell specification to CIE Luv coordinates

Description

MunsellToLuv Converts a Munsell specification to CIE Luv coordinates, by interpolating over the extrapolated Munsell renotation data

Usage

MunsellToLuv( 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 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()

Value

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

Details

The conversion is done in these steps:

• HVC XYZ using MunsellToXYZ()

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

• XYZ Luv using spacesXYZ::LuvfromXYZ() with the given white

References

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

See Also

LuvToMunsell(), MunsellToXYZ(), spacesXYZ::standardXYZ(), spacesXYZ::CAT(), spacesXYZ::adaptXYZ(), spacesXYZ::LuvfromXYZ()

Examples

# NOT RUN {
MunsellToLuv( c('7.6P 8.9/2.2', 'N 5/' ) )
##                      L        u         v
##  7.6P 8.9/2.2 89.19097 5.247155 -5.903808
##  N 5/         51.00375 0.000000  0.000000
# }