From 094535c010320967639e8e86f974d878e80baa72 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Fri, 1 May 2015 16:13:57 +0200 Subject: Imported Upstream version 1.7.0 --- doc/spec2cie.html | 133 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 68 insertions(+), 65 deletions(-) (limited to 'doc/spec2cie.html') 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 @@ fakeread + charset=windows-1252">

spectro/spec2cie

Summary

- Convert spectral .ti3 - readings into CIE XYZ or L*a*b* readings. FWA compensation may be - applied.
+ Convert reflective spectral .ti3 + readings into CIE XYZ and D50 L*a*b* readings. Apply FWA, plot + spectrums.

Usage

spec2cie [options] input.ti3 + + output.ti3
 -v            Verbose mode
-  -I illum   -    Override - actual instrument illuminant - in .ti3 file:
+  -I illum   + + +    Override actual instrument illuminant in .ti3 + file:
           -   -    A, C, D50, D50M2, D65, F5, - F8, F10 or file.sp
+      A, C, D50, D50M2, D65, F5, F8, F10 or + file.sp
                - (only - used in conjunction with -f)
+ + + (only used in conjunction with -f)
 -f [illum] -    Use Fluorescent Whitening Agent compensation - [simulated inst. illum.:
+ href="colprof.html#f">-f [illum]    Use + Fluorescent Whitening Agent compensation [simulated inst. + illum.:
                + + M0, M1, M2, A, C, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp]
             -   -     - A, C, D50 (def.), D50M2, D65, F5, +       A, C, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp
-  -o - observ  -    Choose CIE Observer for spectral - data:
+  -o observ  + + +    Choose CIE Observer for spectral data:
                 + + 1931_2 (def.), - 1964_10, S&B - 1955_2, shaw, J&V 1978_2
+ 1964_10, S&B 1955_2, shaw, J&V 1978_2
 -n             Don't output + + spectral values
 -p             - Plot - each values spectrum
- -  input.ti3      + Plot each values spectrum
+  input.ti3      Measurement + + file
 output.ti3     - Converted - measurement file
+ + + Converted measurement file

Comments

- 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.

+ If FWA correction is applied, then the spectra saved will be FWA + corrected, as well as the XYZ and D50 L*a*b* values.
+
All other columns are copied from the input to the output .ti3 file.

+ 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.
+

The -I 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 -f - flag. If a - filename is specified instead, it will be assumed to be an Argyll - specific .sp - custom spectrum file. - Illuminant details are:
+ 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 -f + flag. If a filename is specified instead, it will be assumed to be + an Argyll specific .sp custom + spectrum file. Illuminant details are:

        A   CIE - tungsten - filament lamp 2848K
+ tungsten filament lamp 2848K
        D50 CIE daylight 5000K
        D65 CIE daylight 6500K
        F5  CIE Fluorescent @@ -107,8 +114,7 @@ Measurement         F8  CIE Fluorescent 5000K, CRI 95
        F10 CIE Fluorescent - 5000K, - CRI 81
+ 5000K, CRI 81


The -f 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 D50 or CIE computation illuminant used for FWA (see -i below). See + + colprof -f for a fuller explanation.

The -i parameter allows specifying a @@ -129,8 +137,7 @@ Measurement D50, D65, F5, F8, F10 are a selection of standard illuminant spectrums, with D50 being the default. If a filename is specified instead, it will be assumed - to be an Argyll specific .sp + to be an Argyll specific .sp custom spectrum file. This only works if spectral data is available. Illuminant details are:

@@ -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.
-
+ degree observer. Profiles should only be linked with other profiles + that have the same illuminant and observer.


The -n 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.
+ 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.

The -p flag causes each spectrum to be plotted. If FWA compensation is used, - then - the before/after compensation spectrums will be shown.
+ then the before/after compensation spectruma will be shown.



-- cgit v1.2.3