1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
% 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.
|
