diff options
Diffstat (limited to 'doc/colverify.html')
| -rw-r--r-- | doc/colverify.html | 209 |
1 files changed, 209 insertions, 0 deletions
diff --git a/doc/colverify.html b/doc/colverify.html new file mode 100644 index 0000000..3f8bc72 --- /dev/null +++ b/doc/colverify.html @@ -0,0 +1,209 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<html> + <head> + <title>colverify</title> + <meta http-equiv="content-type" content="text/html; + charset=ISO-8859-1"> + <meta name="author" content="Graeme Gill"> + </head> + <body> + <h2><b>profile/colverify</b></h2> + <h3>Summary</h3> + Verify a color transform by comparing CIE measurement values from + two test charts. The charts can be any suitably formatted CGATS or <a + href="File_Formats.html#.ti3">.ti3</a> format that contains + corresponding XYZ, Lab or spectral values. The overall average and + worst case delta E will be reported, as well as the worst 10% and + best 90% of values.<br> + <h3>Usage Summary</h3> + <tt><small>colverify [-options] target.ti3 measured.ti3<br> + -v + [n] + Verbose mode, n >= 2 print each value<br> + -n +Normalise + + + each files reading to white Y<br> + -N +Normalise + + + each files reading to white XYZ<br> + -D +Use + + + D50 100.0 as L*a*b* white reference<br> + -c + + + + Show CIE94 delta E values<br> + -k + Show CIEDE2000 delta E values<br> + -s + Sort patch value by error<br> + -w + + + + create VRML vector visualisation (measured.wrl)<br> + </small></tt><tt><small> -W + + create VRML marker & vector visualisation + (measured.wrl)</small></tt><tt><br> + </tt><tt> </tt><tt><small> -x + + + + Use VRML axes<br> + </small></tt><tt><small><small>-f + [illum] Use Fluorescent + Whitening Agent compensation [opt. simulated inst. illum.:<br> + + + + M0, M1, M2, A, C, D50 (def.), D50M2, D65, F5, F8, F10 or + file.sp]<br> + -i illum + Choose illuminant for computation of CIE XYZ from spectral + data & FWA:<br> + + + + A, C, D50 (def.), D50M2, D65, F5, F8, F10 or file.sp<br> + -o observ Choose + CIE Observer for spectral data:<br> + </small><small> + + + 1931_2 </small><small>(def.)</small><small>, 1964_10, S&B + 1955_2, shaw, J&V 1978_2<br> + -L profile.icm Skip any first file out of + profile gamut patches<br> + -X file.ccmx Apply Colorimeter + Correction Matrix to second file<br> + </small> <i>target.ti3</i> + Target or reference patch data file<br> + <i>measured.ti3</i> Measured or actual patch + data file</small></tt><br> + <h3>Usage Details and Discussion</h3> + <b> colverify</b> provides a way of verifying how well a color + transformation (such a proofing) performs.<br> + <br> + The <b>-v</b> flag prints out extra information during the + checking, and prints each patch value, rather than just a summary.<br> + <br> + The <b>-n</b> flag causes the two sets of values to be normalized + to the Y value of white for each set before comparison. White is + assumed to be the patch with the largest Y value.<br> + <br> + The <b>-N</b> flag causes the two sets of values to be normalized + to the XYZ of white for each set before comparison. White is assumed + to be the patch with the largest Y value.<br> + <br> + The <b>-D</b> flag causes the white reference point for the + conversion to L*a*b* to be D50 with a Y value of 100%. By default + the sample with the largest Y value is found, and the L*a*b* white + reference scaled to have that Y value. This allows sensible delta E + values when comparing absolute color values, such as those from + emission or display measurements.<br> + <br> + The <b>-c</b> option causes the differences between the test values + and the profile prediction of the color for each device value to be + displayed in CIE94 delta E, rather than plain L*a*b* delta E. CIE94 + delta E has a closer correspondence with perceived color differences + than the default CIE76 delta E values.<br> + <br> + The <b>-k</b> option causes the differences between the test values + and the profile prediction of the color for each device value to be + displayed in CIEDE2000 delta E, rather than plain L*a*b* delta E. + CIEDE2000 delta E has a closer correspondence with perceived color + differences than either CIE76 or CIE94 delta E values.<br> + <br> + If the <b>-s </b>flag is used in combination with the <b>-v</b> + flag, then the test point by test point output will be sorted from + worst to best.<br> + <br> + The <b>-w</b> creates a <a href="File_Formats.html#VRML">VRML</a> + 3D visualization of the differences between the test points in D50 + L*a*b* space, each difference being shown as a line vector. If the <span + style="font-weight: bold;">-W</span> flag is used, then the target + and measured values will also be marked by a small sphere. This can + be used to visualize the placement of values in a .ti3 (or other + CGATS file) by using the same file for both "target" and "measured" + values.<br> + <br> + The <b>-x</b> flag adds Lab axes to the VRML output.<br> + <br> + The <b>-f</b> flag enables Fluorescent Whitening Agent (FWA) + compensation. This only works if spectral data is available and, the + instrument is not UV filtered. FWA compensation adjusts the + spectral samples so that they appear to have been measured using an + illuminant that has a different level of Ultra Violet to the one the + instrument actually used in the measurement. The optional + illumination parameter allows specifying a 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. The + same value should be used as was used during the creation of the + profile.<br> + <br> + The <b>-i</b> flag allows specifying a standard or custom + illumination spectrum, applied to the spectral test point values to + compute 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 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. The same value should be used as was used during the + creation of the profile.<br> + <br> + The <b>-o</b> flag allows specifying a tristimulus observer, and is + used to compute PCS (Profile Connection Space) tristimulus values. + The following choices are available:<br> + <b> 1931_2</b> selects the standard CIE 1931 2 degree + observer. The default.<br> + <b>1964_10</b> selects the standard CIE 1964 10 degree + observer.<br> + <b>1955_2</b> selects the Stiles and Birch 1955 2 degree + observer<br> + <b>1978_2 </b>selects the Judd and Voss 1978 2 degree + observer<br> + <b>shaw</b> selects the Shaw and Fairchild 1997 2 degree + observer<br> + <br> + The same parameter value should be used as was used during the + creation of the profile.<br> + <br> + The <b>-L</b><b> profile.icm</b> parameter causes colverify to ignore + any patches from the first file that are out of gamut according to + the profile. This can be useful in evaluating accuracy without + tainting it by impossible to reach colors.<br> + <br> + The <b>-X</b><b> file.ccmx</b> option applies the given 3x3 + calibration matrix to the values from the second file before doing + any verification. This can be useful in evaluating the effects of a + calibration matrix on raw colorimeter values, against reference + values measured using a spectrometer.<br> + <br> + If both CIE and spectral values are present in the input files, the + CIE values will be used by default. Using the <span + style="font-weight: bold;">-i</span>, <span style="font-weight: + bold;">-o</span> or <span style="font-weight: bold;">-f</span> + flag will force spectral values to be used. The the <span + style="font-weight: bold;">-i</span>, <span style="font-weight: + bold;">-o</span> or <span style="font-weight: bold;">-f</span> + flags will apply to both the target and measured input files.<br> + <br> + <br> + <br> + <br> + <br> + <br> + </body> +</html> |