officialXYZ {colorSpec} | R Documentation |
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
|
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 NA
s.
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.
See Also
ABC
,
D50
,
D65
,
Fluorescents
,
illuminantE
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