This file is indexed.

/usr/share/doc/argyll-doc/illumread.html is in argyll-doc 2.0.0+repack-1build1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>illumread</title>
    <meta http-equiv="content-type" content="text/html;
      charset=windows-1252">
    <meta name="author" content="Graeme Gill">
  </head>
  <body>
    <h2><b>spectro/illumread</b></h2>
    <h3>Summary</h3>
    Use an instrument or instruments to measure an illuminant spectrum,
    including estimate its Ultra Violet content. A combination of direct
    illumination readings and readings from a piece of paper having some
    FWA content are used for this. (If the UV content is not needed, or
    a suitable instrument is not available, then <a
      href="spotread.html">spotread</a> should be used instead.)<br>
    <h3>Usage Summary</h3>
    <small><span style="font-family: monospace;">illumread [-options]
        illuminant.sp</span><br style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;</span><a
        style="font-family: monospace;" href="#v">-v</a><span
        style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;







        &nbsp; &nbsp; Verbose mode</span><span style="font-family:
        monospace;"></span></small><small><span style="font-family:
        monospace;"></span></small><br style="font-family: monospace;">
    <small><span style="font-family: monospace;"></span><span
        style="font-family: monospace;">&nbsp;</span><a
        style="font-family: monospace;" href="#S">-S</a><span
        style="font-family: monospace;">
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
        &nbsp; &nbsp; &nbsp; Plot the readings in a graph window.</span><br
        style="font-family: monospace;">
      <span style="font-family: monospace;">&nbsp;</span><a
        style="font-family: monospace;" href="#c">-c comport</a><span
        style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Set







        COM port, 1..4 (default 1)</span><span style="font-family:
        monospace;"></span><span style="font-family: monospace;"></span><span
        style="font-family: monospace;"></span></small><small><span
        style="font-family: monospace;"></span></small><font size="-1"><span
        style="font-family: monospace;"></span></font><font size="-1"><span
        style="font-family: monospace;"><br>
      </span></font><font size="-1"><span style="font-family:
        monospace;">&nbsp;<a href="#N">-N</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Disable







        initial calibration of instrument</span></font> if possible<br>
    <font size="-1"><span style="font-family: monospace;">&nbsp;</span><a
        style="font-family: monospace;" href="#H">-H</a><span
        style="font-family: monospace;">
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Use high resolution spectrum mode
        (if available)<br>
        <font size="-1">&nbsp;<a href="#Yr">-Y r</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;






          Set refresh measurement mode</font><br>
      </span></font><font size="-1"><span style="font-family:
        monospace;">&nbsp;<a href="#W">-W n|h|x</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Override







        serial port flow control: n = none, h = HW, x = Xon/Xoff</span></font><br>
    <small><span style="font-family: monospace;">&nbsp;</span><a
        style="font-family: monospace;" href="#T">-T</a><span
        style="font-family: monospace;">
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;





        Test mode - restore &amp; save measurements to<br>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;




        *_i.sp, *_r.sp, *_p.sp, *_mpir.sp, *_cpir.sp files<br>
      </span></small> <small><span style="font-family: monospace;">&nbsp;</span><a
        style="font-family: monospace;" href="#D">-D [level]</a><span
        style="font-family: monospace;">
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
        Print debug diagnostics to stderr</span></small><br>
    &nbsp; <font size="-1"><span style="font-family: monospace;"><a
          href="#file"><span style="font-style: italic;">illuminant.sp</span></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
File







        to save measurement to<br style="font-family: monospace;">
      </span></font><small><span style="font-family: monospace;"></span><span
        style="font-family: monospace;"></span></small><br>
    <h3>Usage Details and Discussion</h3>
    <b>illumread</b> uses a suitable instrument to read an illuminant
    spectrum, and uses an indirect method to estimate the Ultra Violet
    content of the illuminant, so as to provide better accuracy with <a
      href="FWA.html">FWA compensation</a>. An instrument or combination
    of instruments capable of spectral measurement of both emissive
    measurement and reflective measurement without a U.V. filter is
    required for this.<br>
    <br>
    <a name="v"></a>The <b>-v</b> flag causes extra information to be
    printed out during chartread operation.<br>
    <br>
    <a name="S"></a>The <b>-S</b> flag enables the plotting of the
    spectral reflectance/transmittance values. You must select the plot
    window and strike a key in it to continue with another measurement.<br>
    <br>
    <a name="c"></a> The instrument is assumed to communicate through a
    USB or serial communication port, and the initial port can be
    selected with the <b>-c</b> option, if the instrument is not
    connected to the first port. If you invoke <span
      style="font-weight: bold;">illumread</span> so as to display the
    usage information (i.e. "illumread -?" or "illumread --"), then the
    discovered USB and serial ports will be listed. On UNIX/Linux, a
    list of all possible serial ports are shown, but not all of them may
    actually be present on your system.<br>
    <br>
    <a name="N"></a><span style="font-weight: bold;">-N</span> Any
    instrument that requires regular calibration will ask for
    calibration on initial start-up. Sometimes this can be awkward if
    the instrument is being mounted in some sort of measuring jig, or
    annoying if several sets of readings are being taken in quick
    succession. The -<span style="font-weight: bold;">N</span>
    suppresses this initial calibration if a valid and not timed out
    previous calibration is recorded in the instrument or on the host
    computer. It is advisable to only use this option on the second and
    subsequent measurements in a single session.<br>
    <br>
    <a name="H"></a> The -<span style="font-weight: bold;">H</span>
    option turns on high resolution spectral mode, if the instrument
    supports it. See <a href="instruments.html">Operation of particular
      instruments</a> for more details.<br>
    <br>
    <a name="Yr"></a> The -<span style="font-weight: bold;">Y r</span>
    option turns on refresh mode measurement, if the instrument supports
    it. This may improve the repeatability of measurements of
    illuminants that have a repetitive flicker.<br>
    <br>
    <a name="W"></a>The <b>-W</b> <span style="font-weight: bold;">n|h|x</span>
    parameter overrides the default serial communications flow control
    setting. The value <span style="font-weight: bold;">n</span> turns
    all flow control off, <span style="font-weight: bold;">h</span>
    sets hardware handshaking, and <span style="font-weight: bold;">x</span>
    sets Xon/Xoff handshaking. This commend may be useful in workaround
    serial communications issues with some systems and cables. <br>
    <br>
    <a name="T"></a>The <b>-T</b> flag invokes the test mode. In test
    mode the three measurements are saved to files <i>illuminant</i><i>_i.sp</i>
    (Illuminant spectrum), <i>illuminant</i><i>_r.sp</i> (Illuminant
    off paper spectrum), and <i>illuminant_p.sp (</i>Instrument
    measured paper reflectance spectrum), and these will be loaded if
    discovered, allowing a replay of the calculation without requiring
    any measurement. In addition, two diagnostic files <i>illuminant</i><i>_mpir.sp</i>
    (Measured paper under illuminant spectrum) and <i>illuminant</i><i>_cpir.sp




      (</i>Computed paper under illuminant spectrum) will be saved.<br>
    <br>
    <a name="D"></a>The <b>-D</b> flag causes communications and other
    instrument diagnostics to be printed to stdout. A level can be set
    between 1 .. 9, that may give progressively more verbose
    information, depending on the instrument. This can be useful in
    tracking down why an instrument can't connect.<br>
    <br>
    <a name="file"></a>The <span style="font-weight: bold; font-style:
      italic;">illuminant.sp</span> is the name of the file to save the
    resulting illuminant spectrum to. The format used is <a
      href="File_Formats.html#.sp">.sp</a>.<br>
    <br>
    <hr style="width: 100%; height: 2px;"><br>
    Unlike the other measurement utilities, <span style="font-weight:
      bold;">illumread</span> doesn't connect to the instrument until it
    is about to make a measurement. This allows for the possibility of
    using a different instrument for each measurement.<br>
    <br>
    It will display a menu:<br>
    <br>
    Press 1 .. 6<br>
    1) Measure direct illuminant<br>
    2) Measure illuminant reflected from paper<br>
    3) Measure paper<br>
    4) Select another instrument, Currently 1 'usb:/bus4/dev2/
    (GretagMacbeth i1 Pro)'<br>
    5) Compute illuminant spectrum, average result with 0 previous
    readings &amp; save it<br>
    6) Compute illuminant spectrum from this reading &amp; save result<br>
    7) Exit<br>
    <br>
    There are three measurements to be made, after which the illuminant
    can be computed and saved. Before each measurement, the instrument
    may need calibrating.<br>
    <br>
    The first measurement needs a spectral instrument capable of reading
    in an ambient or emissive mode. For instance, a Spectrolino, Eye-One
    Pro or ColorMunki would be suitable instruments.<br>
    <br>
    The second measurement needs a spectral instrument capable of
    reading in an projector or emissive mode. For instance, a
    Spectrolino, Eye-One Pro or ColorMunki would be suitable
    instruments.<br>
    <br>
    The third measurement needs a spectral instrument capable of reading
    in reflective mode with UV included. For instance, a Spectrolino,
    Eye-One Pro, DTP20, DTP22 or&nbsp; DTP41 would be suitable
    instruments, as long as they are not fitted with UV filters.<br>
    <br>
    To be able to estimate the level of Ultra Violet (UV) light in the
    illuminant, a reasonable sized piece of white paper needs to be
    used. The paper should have some noticeable level of FWA
    (Fluorescent Whitener Additive, or Optical Brightening Agents) in
    it, so that it responds to UV light. A piece of cheap copier paper
    is ideal, since cheap paper is typically whitened with large amounts
    of FWA. If the paper is thin (less than 160 gsm) then two or three
    sheets should be used to prevent any background showing through. If
    the intention is to use the illuminant spectrum for proofing to a
    particular paper, then it's best to use the intended paper for this
    purpose.<br>
    <br>
    The first measurement <span style="font-weight: bold;">1)</span>,
    is to use either the ambient or emissive measurement mode to measure
    the illumination directly.<br>
    <br>
    <div style="margin-left: 40px;">If the instrument supports an
      ambient measurement capability, then it will be used. If the
      insrument does not have an ambient mode, then an emissive
      measurement mode can be used, although typically many illuminants
      are too bright to directly point the instrument at. A work-around
      is to reflect the illuminant from a spectrally flat white surface.
      A good candidate for this is a piece of white, fine textured
      polystyrene foam. [The suitability of a reflector can be checked
      using <span style="font-weight: bold;">spotread -S</span> to
      check that the reflection characteristic is close to flat.]<br>
      <br>
      <img alt="Measuring Ambient" src="illumread_1.jpg" width="143"
        height="272"> <img style="width: 141px; height: 282px;"
        alt="Measuring Ambient" src="illumread_2.jpg">&nbsp; <img
        style="width: 226px; height: 282px;" alt="Measuring Ambient"
        src="illumread_3.jpg"><br>
    </div>
    <br>
    The second measurement <span style="font-weight: bold;">2)</span>,
    is to measure the illuminant after it has reflected from the paper.<br>
    <br>
    <div style="margin-left: 40px;">This is done by placing the paper
      such that it is uniformly illuminated with reasonable brightness,
      and then placing the instrument so that it receives the reflected
      light from the paper. This is typically achieved by placing the
      instrument close to the paper at about 45ยบ, so that it's aperture
      has a clear view of the illuminated paper, but avoiding shadowing
      the region that is in view, and also avoiding measuring specular
      reflection if the paper is glossy.<br>
      <br>
      <img style="width: 219px; height: 261px;" alt="Measuring via
        Paper" src="illumread_5.jpg"><img style="width: 252px; height:
        259px;" alt="Measuring via Paper" src="illumread_4.jpg"><br>
    </div>
    <br>
    The third measurement <span style="font-weight: bold;">3)</span>,
    is to measure the paper directly using the instrument reflective
    mode measurement.<br>
    <div style="margin-left: 40px;"><img style="width: 186px; height:
        162px;" alt="Measuring Paper" src="illumread_6.jpg"><br>
    </div>
    If a different instrument is needed, use <span style="font-weight:
      bold;">4)</span> to select from the available instruments attached
    to your computer.<br>
    <br>
    Once these three measurements have been made, then the illuminant
    readings spectrum can be computed and save using <span
      style="font-weight: bold;">6)</span>, or a series of readings can
    be made with each reading being averages with the previous readings
    before saving it by using <span style="font-weight: bold;">5)</span>.
    Note that the averaged readings will be weighted by their absolute
    intensities, and that while the direct and indirect illumination
    needs measuring for each reading, the same paper measurement can be
    used each time.<br>
    <br>
    If plotting is enabled, a plot of the measured (black) and with
    estimated UV (red) is plotted. This is followed by a plot showing
    measured paper reflectance (black) and the FWA calculated paper
    reflectance (red).<br>
    <br>
    <br>
    Illumread can then be terminated using <span style="font-weight:
      bold;">7)</span>.<br>
    <br>
    <br>
    <br>
    <br>
    <br>
    <br>
    <br>
    <br>
    <br>
    <br>
    <br>
  </body>
</html>