>Psychtoolbox>PsychColorimetricData>PsychColorimetricMatFiles

Psychtoolbox:PsychColorimetricData:PsychColorimetricMatFiles.

help PsychColorimetricData
help PsychColorimetric

This folder holds colorimetric data in .mat file form.
All data files are in a standard format.

A very useful source for on-line
colorimetric data is the CVRL database:
http://cvrl.ioo.ucl.ac.uk/
Many of the functions used here were downloaded from
that source and then splined to the wavelength sampling
used here (with extension by zeros).

B_xxx files contain basis functions. The basis functions themselves
are in the columns of a matrix with name B_xxx. There is also
a 3 by 1 row vector S_xxx that contains the wavelength sampling
information in the form [start delta numberSamples] where start
and delta are in nanometers.

den_xxx files contain optical density data. In log units. To
convert density values to transmittance, take 10^(-den). There
is also an S_xxx vector. Curiously, these are in column vectors
in the .mat files.

spd_xxx files contain spectral power distributions. Data are in
columns of matrix with name spd_xxx. There is also a S_xxx
vector.

sur_xxx files contain surface reflectance functions (range 0-1). Data
are in columns of matrix with name sur_xxx. There is also an S_xxx
vector.

T_xxx contain color matching functions or spectral sensitivities. Data
are in rows of a matrix with name T_xxx. There is also an S_xxx
vector. All are in energy units, so that multiplying by spectra in
energy (not quanta) gives desired result (often proportional to
isomerization rate).

Specific data files are listed below. Most, but not all, are sampled
between 380 nm and 780 nm at 5 nm intervals (S = [380 5 81]). This is
the CIE standard. Good coding practice requires using the S_xxx vector
loaded with the data and splining to the wavelength sampling you want to work
in. If I were to start this database again, I would have kept each function
at the resolution of its source.

In some cases, the original data were interpolated or extraploated (with zeros)
to put them data onto the CIE standard [380 5 81] wavelength.

See also: EnergyToQuanta, QuantaToEnergy, MakeItS, MakeItWls, MakeItStruct,
SplineSpd, SplineSrf, SplineCmf.

B_cieday - CIE daylight basis functions.
B_cohen - Cohens basis functions for Munsell surfaces.
B_monitor - Basis functions for a color monitor.
B_nickerson - Basis functions for Munsell surfaces.
B_roomillum - Basis functions for illuminants in Brainard’s room.
B_vrhel - Basis functions for Vrhel surface measurements.
den_lens_ws - Relative lens density data (re 700 nm). W&S, Table 1(2.4.6), p. 109.
- This is the first data set in the table, not the Norren and Vos
- data. It is for an open pupil.
den_lens_cie_1 - Part one of CIE component lens density function. CIE 170-1:2006, Table 6.10
den_lens_cie_2 - Part two of CIE component lens density function. CIE 170-1:2006, Table 6.10
den_lens_ssf - Stockman-Sharpe-Fach (1999) lens optical density spectrum.
- See CVRL database, CIE 170-1:2006, Table 6.10, 32 yo, pupil <= 3 degrees.
- This is also the sum of den_lens_cie_1 and den_lens_cie_2
den_mac_bone - Macular pigment density from Bone et al. (1992). See CVRL database, CIE 170-1:2006, Table 6.4, 2-deg.
den_mac_vos - Macular pigment density from Vos. See CVRL database.
den_mac_ws - Macular pigment density from W&S, Table 2(2.4.6), p. 112.
spd_appratusrel - Relative spectrum from a monitor. Used by IsomerizationInDishDemo.
spd_CIEA - Spectral power distribtion for CIE illuminant A.
spd_CIEC - Spectral power distribution for CIE illuminant C.
spd_D65 - Spectral power distribution for CIE illuminant D65.
spd_houser - 401 normalised illuminant spectral power distributions from:
Review of measures for light-source color rendition and considerations for a two-measure system for characterizing color rendition
Kevin W. Houser, Minchen Wei, Aurélien David, Michael R. Krames, and Xiangyou Sharon Shen
Optics Express, Vol. 21, Issue 8, pp. 10393-10411 (2013)
http://dx.doi.org/10.1364/OE.21.010393
The mat file also contains a labels_houser variable, which is a cell array of string labels
for each spectrum.
spd_flourescent - Spectral power distribution for some flourescent lamp.
spd_incanCC - Spectral power distributions for Macbeth color checker patches under some incandescent lamp.
spd_phillybright - Direct bright sunlight measured through window and off of a piece of white paper towel
- on the floor of DB’s office in Philly, March 2013.
- Measurements made with PR-650, power in Watts/[m2-sr-wlband].
spd_xenonArc - Spectral power distribution for some xenon arc lamp.
spd_xenonFlash - Spectral power distribuiton for some xenon flash tube.
sur_koivisto - Koivisto reflectance measurements. Also has a labels variable.
- Converted from ASCII sourced from http://www.uef.fi/web/spectral/natural-colors
- using this script: https://github.com/da5nsy/Melanopsin_Computational/blob/4195492841471f943f62194d345269cbefcccec8/Auxiliary%20Scripts/loadKoivistoData.m
sur_krinov - Krinov reflectance measurements. Also has a labels variable.
- These were typed in by Larry Maloney long ago
- and put into PTB format by Danny Garside.
- See this script for code that extracted data
- from the text file as well as some comments about
- it: https://github.com/da5nsy/Melanopsin_Computational/blob/6a739e8d1e8c4e03a399b48727499407dddf6839/Auxiliary%20Scripts/Krinov_extract.m
sur_nickerson - The Nickerson measurements of the Munsell papers.
sur_macbeth - Reflectance of Macbeth color checker (not accurate, needs updating).
sur_vrhel - Reflectances measured by Vrhel.
T_CIE_Y2 - CIE physiologically relevant 2-degree luminosity function. See CVRL database.
T_CIE_Y10 - CIE physiologically relevant 10-degree luminosity function. See CVRL database.
T_cones_smj - Stockman-MacLeod-Johnson cone fundamentals. See CVRL database.
T_cones_smj10 - Stockman-MacLeod-Johnson 10-degree cone fundamentals. See CVRL database.
T_cones_ss2 - Stockman-Sharpe (2000) 2-degree cone fundamentals. Also the CIE 2006 fundamentals. See CVRL database.
T_cones_ss10 - Stockman-Sharpe (2000) 10-degree cone fundamentals. Also the CIE 2006 fundamentals. See CVRL database.
T_cones_sp - Smith-Pokorny cone fundamentals. Computed using PTB’s JuddVosToSmithPokorny. Each fundamental normalized to a max of 1.
T_cones_sp_orig - Original PTB version of Smith-Pokorny cone fundamentals. Specified between 380 and 780 nm,
- but non-zero only between 400 and 700 nm.
- This is probably because these were typed in by hand long ago from a table that only had data between 400 and 700 nm
- and then zero extended to match the wavelength sampling of other data files.
- It might be good to update these with data over the full specified range.
T_dogrec - Estimates of dog photoreceptor fundamentals. Order in file is L cone, S cone, rod.
T_DCS200 - Sensitivities of a Kodak DCS-200 color camera.
T_ground - Not entirely sure what this is, but it might be ground squirrel receptor sensitivities.
T_Lanom - Demarco et al. anomolous L cone sensitivity.
T_log10coneabsorbance_ss - Stockman-Sharpe (2000) log10 LMS cone photopigment absorbance.
- See CVRL database, CIE 170-1:2006, Table 6.6.
- Some S-cone values were unspecified for wls > 615 nm in the table.
- These were filled in here by linear extrapolation.
- Note that you want to raise 10 to these numbers
- to get absorbance, which itself is a log-like quantity.
T_Manom - Demarco et al. anomolous M cone sensitivity.
T_photopigments_ss - Removed. Use T_log10coneabsorbance and raise 10 to it.
T_melanopsin - Melanopsin fundamental as provided by Lucas at
- http://lucasgroup.lab.ls.manchester.ac.uk/research/measuringmelanopicilluminance/
- This is for human observers at the cornea, in energy units. Normalized to peak
- of unity.
T_rods - CIE scotopic luminous efficiency function.
T_stiles2 - Stiles-Burch 2-degree color matching functions.
T_stiles10 - Stiles-Burch 10-degree color matching functions.
T_ss2000_Y2 - Stockman-Sharpe (2000) 2-degree photopic luminance efficiency function. See CVRL database.
T_vos1978_Y - Judd-Vos 1978 photopic luminance efficiency function.
T_xyz1931 - CIE 1931 color matching functions (2-degree).
T_xyz1964 - CIE 1964 supplemental color matching functions (10-deg).
T_xyzCIEPhys2 - CIE XYZ CMF’s based on CIE 2-deg cone fundamentals.
- Obtained in 2016 from CVRL. At this time, these are proposed.
T_xyzCIEPhys10 - CIE XYZ CMF’s based on CIE 10-deg cone fundamentals.
- Obtained in 2016 from CVRL. At this time, these are proposed.
T_xyzJuddVos - Judd-Vos modified color matching functions.