% Psychtoolbox:PsychColorimetricData:PsychColorimetricMatFiles.
%
% help Psychtoolbox % For an overview, triple-click me & hit enter.
% help PsychDemos % For demos, triple-click me & hit enter.
% 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.