summaryrefslogtreecommitdiff
path: root/doc/spotread.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/spotread.html')
-rw-r--r--doc/spotread.html468
1 files changed, 435 insertions, 33 deletions
diff --git a/doc/spotread.html b/doc/spotread.html
index 3fe030f..36ee999 100644
--- a/doc/spotread.html
+++ b/doc/spotread.html
@@ -47,6 +47,15 @@
+
+
+
+
+
+
+
+
+
&nbsp; &nbsp; &nbsp; Verbose mode</span><br style="font-family:
monospace;">
<span style="font-family: monospace;"></span><span
@@ -80,6 +89,15 @@
+
+
+
+
+
+
+
+
+
&nbsp; &nbsp; &nbsp; Print spectrum for each reading.</span></small><br
style="font-family: monospace;">
<small><span style="font-family: monospace;"></span><span
@@ -118,6 +136,15 @@
+
+
+
+
+
+
+
+
+
Set COM port, 1..4 (default 1)</span><span style="font-family:
monospace;"></span><span style="font-family: monospace;"><br
style="font-family: monospace;">
@@ -150,6 +177,15 @@
+
+
+
+
+
+
+
+
+
&nbsp; &nbsp; &nbsp; Use transmission measurement mode</span><br
style="font-family: monospace;">
<span style="font-family: monospace;">&nbsp;</span><a style="
@@ -182,6 +218,15 @@
+
+
+
+
+
+
+
+
+
Use emissive measurement mode (absolute results)<br>
</span></small><small><span style="font-family: monospace;">&nbsp;</span><a
style=" font-family: monospace;" href="#eb">-eb</a><span
@@ -213,6 +258,15 @@
+
+
+
+
+
+
+
+
+
Use display white brightness relative measurement mode<br>
</span></small><small><span style="font-family: monospace;">&nbsp;</span><a
style=" font-family: monospace;" href="#ew">-ew</a><span
@@ -227,6 +281,15 @@
+
+
+
+
+
+
+
+
+
Use display white point relative chromatically adjusted mode<br>
</span></small><small><span style="font-family: monospace;">&nbsp;</span><a
style=" font-family: monospace;" href="#p">-p</a><span
@@ -258,6 +321,15 @@
+
+
+
+
+
+
+
+
+
Use telephoto measurement mode (absolute results)<br>
</span></small><small><span style="font-family: monospace;">&nbsp;</span><a
style=" font-family: monospace;" href="#pb">-pb</a><span
@@ -289,6 +361,15 @@
+
+
+
+
+
+
+
+
+
Use </span></small><small><span style="font-family: monospace;">projector</span></small><small><span
style="font-family: monospace;"> white brightness relative
measurement mode<br>
@@ -322,6 +403,15 @@
+
+
+
+
+
+
+
+
+
Use </span></small><small><span style="font-family: monospace;">projector</span></small><small><span
style="font-family: monospace;"> </span></small><small><span
style="font-family: monospace;">white point relative
@@ -356,6 +446,15 @@
+
+
+
+
+
+
+
+
+
Use ambient measurement mode (absolute results)<br>
&nbsp;<a href="#f">-f</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -384,6 +483,15 @@
+
+
+
+
+
+
+
+
+
Use ambient flash measurement mode (absolute results)<br>
</span></small><font size="-1"><span style="font-family:
monospace;">&nbsp;<a href="#y">-y X</a>
@@ -414,6 +522,15 @@
+
+
+
+
+
+
+
+
+
Display type - instrument specific list to choose from.</span></font><br>
<small><span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="spotread.html#I">-I illum</a><span
@@ -442,6 +559,15 @@ M0,
+
+
+
+
+
+
+
+
+
M1, M2, A, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp</span></small><br
style="font-family: monospace;">
<small><span style="font-family: monospace;"></span><span
@@ -487,6 +613,15 @@ D50
+
+
+
+
+
+
+
+
+
D50M2, D65, F5, F8, F10 or file.sp</span><br style="font-family:
monospace;">
<span style="font-family: monospace;">&nbsp;</span><a style="
@@ -522,6 +657,15 @@ D50
+
+
+
+
+
+
+
+
+
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; </span></small><small><span
style="font-family: monospace;">1931_2 </span></small><small><span
style="font-family: monospace;"> (def.)</span></small><small><span
@@ -556,6 +700,15 @@ D50
+
+
+
+
+
+
+
+
+
Set filter configuration:<br>
&nbsp;&nbsp;
n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -585,6 +738,15 @@ D50
+
+
+
+
+
+
+
+
+
None<br>
&nbsp;&nbsp;
p&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -614,6 +776,15 @@ D50
+
+
+
+
+
+
+
+
+
Polarising filter<br>
&nbsp;&nbsp;
6&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -643,6 +814,15 @@ D50
+
+
+
+
+
+
+
+
+
D65<br>
&nbsp;&nbsp;
u&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -672,9 +852,27 @@ D50
+
+
+
+
+
+
+
+
+
U.V. Cut<br>
&nbsp;<a href="#E">-E extrafilterfile</a>&nbsp;&nbsp;&nbsp;
Apply extra filter compensation file<br>
+ &nbsp;<a href="#A">-A N|A|X|G</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+
+ XRGA conversion (default N)<br>
</span></font><font size="-1"><span style="font-family:
monospace;">&nbsp;<a href="#x">-x</a>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -704,6 +902,15 @@ D50
+
+
+
+
+
+
+
+
+
Display Yxy instead of Lab<br>
</span></font><font size="-1"><span style="font-family:
monospace;">&nbsp;<a href="#h">-h</a>
@@ -734,6 +941,15 @@ D50
+
+
+
+
+
+
+
+
+
Display LCh instead of Lab</span></font><br>
<font size="-1"><span style="font-family: monospace;">&nbsp;<a
href="#V">-V</a>
@@ -764,6 +980,15 @@ D50
+
+
+
+
+
+
+
+
+
Show running average and std. devation from ref.</span></font><br>
<font size="-1"><span style="font-family: monospace;">&nbsp;<a
href="#T">-T</a>
@@ -794,6 +1019,15 @@ D50
+
+
+
+
+
+
+
+
+
Display correlated color temperatures, CRI and TLCI<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;
@@ -823,6 +1057,15 @@ D50
+
+
+
+
+
+
+
+
+
Disable initial calibration of instrument if possible</span></font><br>
<font size="-1"><span style="font-family: monospace;">&nbsp;<a
href="spotread.html#O">-O</a>
@@ -853,6 +1096,15 @@ D50
+
+
+
+
+
+
+
+
+
Do one cal. or measure and exit</span></font><br>
<font size="-1"><span style="font-family: monospace;">&nbsp;</span><a
style="font-family: monospace;" href="#H">-H</a><span
@@ -860,6 +1112,14 @@ D50
&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>
+ &nbsp;<a href="#R">-R fname.sp</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+ Preset reference to spectrum<br>
&nbsp;</span></font><font size="-1"><span style="font-family:
monospace;"><a href="#X1">-X file.ccmx</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -888,6 +1148,15 @@ D50
+
+
+
+
+
+
+
+
+
Apply Colorimeter Correction Matrix</span></font><br>
<span style="font-family: monospace;">&nbsp;<a href="#X2">-X
file.ccss</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -922,6 +1191,15 @@ Samples
+
+
+
+
+
+
+
+
+
for calibration</span><br>
<font size="-1"><span style="font-family: monospace;">&nbsp;</span><a
style=" font-family: monospace;" href="#Yrn">-<font size="-1">Y</font>
@@ -945,6 +1223,15 @@ Samples
+
+
+
+
+
+
+
+
+
&nbsp;&nbsp;&nbsp;&nbsp; Override refresh, non-refresh display
mode</span></font><br>
<tt>&nbsp;<a href="#YR">-Y R:<i>rate</i></a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@@ -958,6 +1245,15 @@ Samples
+
+
+
+
+
+
+
+
+
Override measured refresh rate with rate Hz</tt><br>
<font size="-1"><span style="font-family: monospace;">&nbsp;</span><a
style=" font-family: monospace;" href="#YA">-<font size="-1">Y </font>A</a><span
@@ -965,6 +1261,17 @@ Samples
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp; Use non-adaptive integration time mode (if
available).</span></font><br>
+ <tt>&nbsp;<a href="#YW">-Y W:fname.sp</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
+
+
+
+
+ Save white tile ref. spectrum to file</tt><br>
+ <tt>&nbsp;<a href="#YL">-Y L</a> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; Test for i1Pro Lamp
+ Drift, and remediate it</tt><br>
<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
@@ -1001,6 +1308,15 @@ none,
+
+
+
+
+
+
+
+
+
h = HW, x = Xon/Xoff</span></font><br>
<small><span style="font-family: monospace;">&nbsp;</span><a style="
font-family: monospace;" href="#D">-D [level]</a><span
@@ -1035,6 +1351,15 @@ none,
+
+
+
+
+
+
+
+
+
Optional file to save reading results<br style="font-family:
monospace;">
</span></font><small><span style="font-family: monospace;"></span><span
@@ -1061,10 +1386,10 @@ none,
The Graph plots light wavelength on the X axis, and either absolute
or relative level on the Y axis. <br>
<br>
- <table cellpadding="0" cellspacing="0" border="1" height="153"
- width="200">
+ <table border="1" cellpadding="0" cellspacing="0" width="200"
+ height="153">
</table>
- <table cellpadding="0" cellspacing="0" border="1">
+ <table border="1" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<th valign="top">&nbsp; Measurement Mode &nbsp; <br>
@@ -1073,20 +1398,29 @@ none,
</th>
</tr>
<tr>
- <td align="center" valign="top">Emission<br>
+ <td valign="top" align="center">Emission<br>
</td>
- <td align="center" valign="top">mW/(m<sup>2</sup>.sr.nm)</td>
+ <td valign="top" align="center">mW/(m<sup>2</sup>.sr.nm)</td>
</tr>
<tr>
- <td align="center" valign="top">Ambient<br>
+ <td valign="top" align="center">Ambient<br>
</td>
- <td align="center" valign="top">mW/(m<sup>2</sup>.nm)<br>
+ <td valign="top" align="center">mW/(m<sup>2</sup>.nm)<br>
</td>
</tr>
<tr>
- <td align="center" valign="top">Emission Flash<br>
+ <td valign="top" align="center">Emission Flash<br>
</td>
- <td align="center" valign="top">&nbsp; mW/(m<sup>2</sup>.sr.nm.s)
+ <td valign="top" align="center">&nbsp; mW/(m<sup>2</sup>.sr.nm.s)
+
+
+
+
+
+
+
+
+
@@ -1097,21 +1431,21 @@ none,
</td>
</tr>
<tr>
- <td align="center" valign="top">Ambient Flash<br>
+ <td valign="top" align="center">Ambient Flash<br>
</td>
- <td align="center" valign="top">mW/(m<sup>2</sup>.nm.s)<br>
+ <td valign="top" align="center">mW/(m<sup>2</sup>.nm.s)<br>
</td>
</tr>
<tr>
- <td align="center" valign="top">Reflective<br>
+ <td valign="top" align="center">Reflective<br>
</td>
- <td align="center" valign="top">%/nm<br>
+ <td valign="top" align="center">%/nm<br>
</td>
</tr>
<tr>
- <td align="center" valign="top">Transmissive<br>
+ <td valign="top" align="center">Transmissive<br>
</td>
- <td align="center" valign="top">%/nm<br>
+ <td valign="top" align="center">%/nm<br>
</td>
</tr>
</tbody>
@@ -1185,11 +1519,19 @@ none,
allows measuring in ambient illumination mode using instruments that
support this mode (i.e. Eye-One Display 2). Values returned are
absolute, and include the various color temperatures and Color
- Rendering Index (see <span style="font-weight: bold;">-T</span>).
+ Rendering Index (<a href="#T">see <span style="font-weight: bold;">-T</span></a>).
+
+
If the instrument does not support ambient mode, emissive mode will
be used instead. An adaptive integration time will be used in
devices that support it. <br>
<br>
+ For an instrument that supports it (i.e. the Emulated transmission
+ measurement mode of the JETI 1211), then using <b>-a</b> after the
+ <b>-t</b> switch will select the alternate 90/diffuse transmission
+ geometry (i.e. using the ambient adapter for transmission
+ measurement).<br>
+ <br>
<a name="f"></a>The <span style="font-weight: bold;">-f</span> flag
allows measuring a flash with those instruments that support
scanning emissive measurements. The instrument needs to be triggered
@@ -1223,13 +1565,10 @@ none,
reflectance instrument illuminant when FWA compensation is used
during <u>measurement</u>, overriding the default <b>D50</b> or
CIE computation illuminant used for FWA (see <b>-i</b> below<b>). </b>If
-
-
- using <b>M0</b>, <b>M1</b> or <b>M2</b>, then the <b>-i</b>
- option is <b>not</b> normally used. See <a href="colprof.html#f">colprof
-
-
- -f</a> for a fuller explanation. <br>
+ intending to use standard <b>M0</b>, <b>M1</b> or <b>M2</b>
+ conditions, then use just the <b>-I</b> option and not the&nbsp; <b>-i</b>
+ option. See <a href="colprof.html#f">colprof -f</a> for a fuller
+ explanation. <br>
<br>
<a name="i"></a>The <b>-i</b> parameter allows specifying a
standard or custom reflectance illumination spectrum applied to <span
@@ -1237,12 +1576,13 @@ none,
spectral data to <u>compute</u> CIE tristimulus values. <b>A</b>,
<b>D50</b>, <b>D50M2, D65</b>, <b>F5</b>, <b>F8</b>, <b>F10</b>
are a selection of standard illuminant spectrums, with <b>D50</b>
- being the default. If using <b>-I M0</b>, <b>M1</b> or <b>M2</b>,
- then this <b>-i</b> option is <b>not</b> normally used. If a
- filename is specified instead, it will be assumed to be an Argyll
- specific <a href="File_Formats.html#.sp">.sp</a> spectrum file. If
- FWA compensation is used during measurement, this illuminant will be
- used by default as the simulated instrument illuminant.<br>
+ being the default. If using <b>-I</b> to obtain standard <b>M0</b>,
+ <b>M1</b> or <b>M2</b> conditions, then this <b>-i</b> option is <b>not</b>
+ normally used. If a filename is specified instead, it will be
+ assumed to be an Argyll specific <a href="File_Formats.html#.sp">.sp</a>
+ spectrum file. If FWA compensation is used during measurement, this
+ illuminant will be used by default as the simulated instrument
+ illuminant.<br>
<br>
<a name="Q"></a> The <b>-Q</b> flag allows specifying a tristimulus
observer, and is used to compute PCS (Profile Connection Space)
@@ -1275,6 +1615,21 @@ none,
style="font-weight: bold;">Note</span> that this is currently only
supported by the Spectrolino driver.]<br>
<br>
+ <a name="A"></a>The <b>-A</b> options allows overriding the default
+ or environment variable set <a href="XRGA.html">XRGA</a>
+ conversion:<br>
+ <br>
+ &nbsp;&nbsp;&nbsp; <b>-A N|A|X|G</b><br>
+ <br>
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; The <b>N</b> argument sets
+ the calibration to Native (default).<br>
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; The <b>A</b> argument sets
+ the calibration to XRGA.<br>
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; The <b>X</b> argument sets
+ the calibration to XRDI.<br>
+ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; The <b>G</b> argument sets
+ the calibration to GMDI.<br>
+ <br>
<a name="x"></a>The <b>-x</b> option causes the reading to be
displayed as XYZ and Yxy values, rather than the default XYZ and
L*a*b*<br>
@@ -1327,6 +1682,13 @@ none,
supports it. See <a href="instruments.html">Operation of particular
instruments</a> for more details.<br>
<br>
+ <a name="R"></a><font size="-1">The <b>-R <i>fname.sp</i></b>
+ option allows specifying a reference spectrum</font> to preset the
+ reference values used to calculate delta E etc. This can be useful
+ in checking against a previously saved value (<b>'s' </b>command),
+ or in checking the instruments consistency against it's <a
+ href="#YW">reflective white reference spectrum</a>.<br>
+ <br>
<a name="X1"></a> The -<span style="font-weight: bold;">X <span
style="font-style: italic;">file.ccmx</span></span> option reads
a <a href="File_Formats.html#.ccmx">Colorimeter Correction Matrix</a>
@@ -1343,10 +1705,8 @@ none,
colorimeters that rely on sensor spectral sensitivity calibration
information (ie. the X-Rite <span style="font-weight: bold;">i1d3</span>,
or the DataColor <span style="font-weight: bold;">Spyder4 &amp;
- Spyder5</span>).This
- can
- improve
- a colorimeters accuracy for a particular type of display.<br>
+ Spyder5</span>).This can improve a colorimeters accuracy for a
+ particular type of display.<br>
<br>
<a name="Yrn"></a> The -<span style="font-weight: bold;">Y r </span>and
@@ -1367,6 +1727,15 @@ none,
+
+
+
+
+
+
+
+
+
<b>-Y n</b> options overrides the refresh display mode set by the <a
href="#y">-y display type selection</a>, with <b>-Y</b><span
style="font-weight: bold;"> r</span> forcing refresh display mode,
@@ -1397,6 +1766,39 @@ none,
sets Xon/Xoff handshaking. This commend may be useful in workaround
serial communications issues with some systems and cables. <br>
<br>
+ <a name="YW"></a>The <b>-Y W:<i>fname.s</i>p</b> option allows
+ saving an instruments reference white tile reflectance spectrum to a
+ file. Reflective instruments use a white reference tile to calibrate
+ against, and typically the spectral reflectance of the white tile is
+ recorded inside the instrument to calibrate to. The saved spectrum
+ can be used to compare against the measurements of a reference grade
+ measurement of the white tile to check for tile deterioration, or
+ can be used as a reference for checking on instrument calibration
+ accuracy or consistency (See the <a href="#R">-R option</a>). Not
+ all instruments support this option (Currently the Spectrolino,
+ i1Pro, i1Pro2 and ColorMunki spectrometer.)<br>
+ <br>
+ <a name="YL"></a> The <b>-Y l|L</b> option is a special function
+ for X-Rite <a href="instruments.html#i1p2">i1Pro</a> instruments.
+ These instruments use an incandescent lamp as a light source for
+ reflectance measurement, and some instruments after some patterns of
+ use, can suffer from Lamp output thermal drift, due to the build up
+ of filament tungsten on the bulb inner surface. This function first
+ measures the Lamp drift, and then if the <b>-Y L</b> version is
+ used and the drift is greater than normal (0.06 - 0.1 Delta E), it
+ will attempt to remediate the problem by turning the lamp on for
+ some seconds so that it reaches normal operating temperature and is
+ able to re-circulate the tungsten back onto the filament properly.
+ It will then wait for the lamp to cool, and re-measure the drift.
+ These operations can take a few minutes, and it is advisable to let
+ the instrument cool off further after this operation, for 2 - 5
+ minutes, to allow it to return to normal operation conditions.<br>
+ <br>
+ The remediation function should be used infrequently or if the
+ repeatability of the instrument seems to be poorer than usual, as
+ frequent use may consume lamp life unnecessarily. If the lamp is
+ nearing its end of life, this function may not be effecive.<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