colorSpec: officialXYZ – R documentation

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

officialXYZ

Query the Official XYZ values for Standard Illuminants

Description

In careful calcuations with standard illuminants, it is often helpful to have the 'official' values of XYZ, i.e. with the right number of decimal places.

Usage

officialXYZ( name )

Arguments

name

a subvector of c('A','B','C','D50','D50.ICC','D55','D65','D75', 'E','F2','F7','F11'), which are the names of some standard illuminants

Details

All XYZ values are taken from the ASTM publication in References, except B which is taken from Wyszecki & Stiles and D50.ICC which is taken from ICC publications. The latter is different than that of ASTM.

Value

An Mx3 matrix where M is the length of name. Each row filled with the official XYZ, but if the illuminant name is not recognized the row is all NAs. The matrix rownames are set to name, and colnames to c('X','Y','Z').

WARNING

This function is deprecated. New software should use spacesRGB::standardXYZ() instead.

Note

The input names are case-sensitive. The output XYZ is normalized so that Y=1.

References

ASTM E 308 - 01. Standard Practice for Computing the Colors of Objects by Using the CIE System. (2001).

Günther Wyszecki and W. S. Stiles. Color Science: Concepts and Methods, Quantitative Data and Formulae, Second Edition. John Wiley & Sons, 1982. Table I(3.3.8) p. 769.

Examples

officialXYZ( c('A','D50','D50.ICC','D65') ) 
#                 X Y         Z
# A       1.0985000 1 0.3558500
# D50     0.9642200 1 0.8252100
# D50.ICC 0.9642029 1 0.8249054
# D65     0.9504700 1 1.0888300

colorSpec

Color Calculations with Emphasis on Spectral Data

v1.2-1

GPL (>= 3)

Authors

Glenn Davis [aut, cre]

Initial release

2020-04-01