summaryrefslogtreecommitdiff
path: root/doc/spec2cie.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/spec2cie.html')
-rw-r--r--doc/spec2cie.html133
1 files changed, 68 insertions, 65 deletions
diff --git a/doc/spec2cie.html b/doc/spec2cie.html
index c928f9a..d25b0a0 100644
--- a/doc/spec2cie.html
+++ b/doc/spec2cie.html
@@ -3,38 +3,43 @@
<head>
<title>fakeread</title>
<meta http-equiv="content-type" content="text/html;
- charset=ISO-8859-1">
+ charset=windows-1252">
<meta name="author" content="Graeme Gill">
</head>
<body>
<h2><b>spectro/</b><span style="text-decoration: underline;"></span>spec2cie</h2>
<h3>Summary</h3>
- Convert spectral <a href="File_Formats.html#.ti3">.ti3</a>
- readings into CIE XYZ or L*a*b* readings. FWA compensation may be
- applied.<br>
+ Convert reflective spectral <a href="File_Formats.html#.ti3">.ti3</a>
+ readings into CIE XYZ and D50 L*a*b* readings. Apply FWA, plot
+ spectrums.<br>
<h3>Usage</h3>
<tt><small>spec2cie [options] <span style="font-style: italic;">input.ti3
+
+
output.ti3<br>
&nbsp;</span></small></tt><tt><small>-v
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Verbose mode</small></tt><br>
- <tt><small><small>&nbsp;<a
- href="spec2cie.html#I">-I <i>illum</i></a>&nbsp;&nbsp;
- &nbsp;&nbsp; Override
- actual instrument illuminant
- in .ti3 file:<br>
+ <tt><small><small>&nbsp;<a href="spec2cie.html#I">-I <i>illum</i></a>&nbsp;&nbsp;
+
+
+ &nbsp;&nbsp; Override actual instrument illuminant in .ti3
+ file:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- &nbsp;
- &nbsp;&nbsp; A, C, D50, D50M2, D65, F5,
- F8, F10 or file.sp<br>
+ &nbsp; &nbsp;&nbsp; A, C, D50, D50M2, D65, F5, F8, F10 or
+ file.sp<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- (only
- used in conjunction with <span style="font-weight: bold;">-f</span>)<br>
+
+
+ (only used in conjunction with <span style="font-weight:
+ bold;">-f</span>)<br>
</small></small></tt><tt><small><small>&nbsp;<a
- href="colprof.html#f">-f [<i>illum</i>]</a>
- &nbsp;&nbsp; Use Fluorescent Whitening Agent compensation
- [simulated inst. illum.:<br>
+ href="colprof.html#f">-f [<i>illum</i>]</a> &nbsp;&nbsp; Use
+ Fluorescent Whitening Agent compensation [simulated inst.
+ illum.:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+
M0, M1, M2, A, C, D50 (def.), D50M2, D65, F5, F8, F10 or
file.sp]<br>
</small></small></tt><tt><small><small><small>&nbsp;<a
@@ -42,64 +47,66 @@
&nbsp;&nbsp; Choose illuminant for computation of CIE XYZ
from spectral data &amp; FWA:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- &nbsp;
- &nbsp;&nbsp;&nbsp;
- A, C, D50 (def.), D50M2, D65, F5,
+ &nbsp; &nbsp;&nbsp;&nbsp; A, C, D50 (def.), D50M2, D65, F5,
F8, F10 or file.sp<br>
- &nbsp;</small></small><a href="#o">-o
- <i>observ</i></a>&nbsp;
- &nbsp;&nbsp; Choose CIE Observer for spectral
- data:<br>
+ &nbsp;</small></small><a href="#o">-o <i>observ</i></a>&nbsp;
+
+
+ &nbsp;&nbsp; Choose CIE Observer for spectral data:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
&nbsp;
&nbsp;&nbsp;
+
+
1931_2 </small></tt><tt><small> (def.)</small></tt><tt><small>,
- 1964_10, S&amp;B
- 1955_2, shaw, J&amp;V 1978_2<br>
+ 1964_10, S&amp;B 1955_2, shaw, J&amp;V 1978_2<br>
&nbsp;<a href="#p">-n</a>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Don't
output
+
+
spectral values<br>
</small></tt><tt><small>&nbsp;<a href="#p">-p</a>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
- Plot
- each values spectrum</small></tt><tt><br>
- </tt><tt>
- </tt><tt><small>&nbsp;<span style="font-style: italic;">input.ti3</span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+ Plot each values spectrum</small></tt><tt><br>
+ </tt><tt> </tt><tt><small>&nbsp;<span style="font-style: italic;">input.ti3</span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Measurement
+
+
file<br>
&nbsp;<span style="font-style: italic;">output.ti3</span>&nbsp;&nbsp;&nbsp;&nbsp;
- Converted
- measurement file</small></tt><br>
+
+
+ Converted measurement file</small></tt><br>
<h3>Comments</h3>
- This program takes the spectral data in a .ti3 file, converts them
- to
- XYZ and Lab and fills the XYZ_[XYZ] and LAB_[LAB] columns in the
- output
- .ti3 file with the computed XYZ and Lab values. If the columns
+ This program takes the (usually reflective) spectral data in a .ti3
+ file, converts them to XYZ and D50 L*a*b* and fills the XYZ_[XYZ]
+ and LAB_[LAB] columns in the output .ti3 file. If the columns
XYZ_[XYZ] and/or LAB_[LAB] are missing in the input file, they are
added to the output file.<br>
<br>
+ If FWA correction is applied, then the spectra saved will be FWA
+ corrected, as well as the XYZ and D50 L*a*b* values.<br>
+ <br>
All other columns are copied from the input to the output .ti3 file.<br>
<br>
+ Setting an actual instrument/simulated instrument/CIE illuminant
+ only has an effect for reflective/transmissive spectra. Emissive
+ spectra don't have an illuminant, and will simply be converted to
+ XYZ using the given observer. <br>
+ <br>
<br>
<a name="I"></a>The <b>-I</b> parameter allows specifying a an
- illumination
- spectrum for the actual instrument illuminant, overriding that
- computed from
- the type of instrument (recorded in the .ti3 file). This is rarely
- used. This parameter is can
- only be used in combination with the <span style="font-weight:
- bold;">-f</span>
- flag. If a
- filename is specified instead, it will be assumed to be an Argyll
- specific <a href="File_Formats.html#.sp">.sp</a>
- custom spectrum file.
- Illuminant details are:<br>
+ illumination spectrum for the actual instrument illuminant,
+ overriding that computed from the type of instrument (recorded in
+ the .ti3 file). This is rarely used. This parameter is can only be
+ used in combination with the <span style="font-weight: bold;">-f</span>
+ flag. If a filename is specified instead, it will be assumed to be
+ an Argyll specific <a href="File_Formats.html#.sp">.sp</a> custom
+ spectrum file. Illuminant details are:<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; A&nbsp;&nbsp; CIE
- tungsten
- filament lamp 2848K<br>
+ tungsten filament lamp 2848K<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; D50 CIE daylight 5000K<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; D65 CIE daylight 6500K<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; F5&nbsp; CIE Fluorescent
@@ -107,8 +114,7 @@ Measurement
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; F8&nbsp; CIE Fluorescent
5000K, CRI 95<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; F10 CIE Fluorescent
- 5000K,
- CRI 81<br>
+ 5000K, CRI 81<br>
<br>
<br>
<a name="f"></a> The <b>-f</b> flag enables Fluorescent Whitening
@@ -121,6 +127,8 @@ Measurement
standard or custom illumination spectrum to be used as the similated
instrument illuminant, overriding the default <b>D50</b> or CIE
computation illuminant used for FWA (see <b>-i</b> below<b>). </b>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
@@ -129,8 +137,7 @@ Measurement
<b>D50</b>, <b>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 a filename is specified instead, it will be assumed
- to be an Argyll specific <a
- href="File_Formats.html#.sp">.sp</a>
+ to be an Argyll specific <a href="File_Formats.html#.sp">.sp</a>
custom spectrum file. This only works if spectral data is available.
Illuminant details are:<br>
<br>
@@ -181,22 +188,18 @@ Measurement
Note that if an observer other than 1931 2 degree is chosen, the
resulting ICC profile will not be standard, and cannot be freely
interchanged with other profiles that that us the standard 1931 2
- degree
- observer. Profiles should only be linked with other profiles that
- have
- the same illuminant and observer.<br>
- <br>
+ degree observer. Profiles should only be linked with other profiles
+ that have the same illuminant and observer.<br>
<br>
<br>
<a name="n"></a>The <span style="font-weight: bold;">-n</span> flag
- disables the output of the spectral values. If just the XYZ and
- L*a*b*
- values are needed, this makes for a smaller, easier to read file.<br>
+ disables the output of the spectral values. If just the XYZ and D50
+ L*a*b* values are needed, this makes for a smaller, easier to read
+ file.<br>
<br>
<a name="p"></a>The <span style="font-weight: bold;">-p</span> flag
causes each spectrum to be plotted. If FWA compensation is used,
- then
- the before/after compensation spectrums will be shown.<br>
+ then the before/after compensation spectruma will be shown.<br>
<br>
<br>
<br>