illumread

From 9491825ddff7a294d1f49061bae7044e426aeb2e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Fri, 6 Nov 2015 05:38:49 +0100 Subject: Imported Upstream version 1.8.3 --- doc/illumread.html | 554 ++++++++++++++++++++++++++--------------------------- 1 file changed, 277 insertions(+), 277 deletions(-) mode change 100644 => 100755 doc/illumread.html (limited to 'doc/illumread.html') diff --git a/doc/illumread.html b/doc/illumread.html old mode 100644 new mode 100755 index 9b65b2f..3ee7aa5 --- a/doc/illumread.html +++ b/doc/illumread.html @@ -1,309 +1,309 @@ - - - - illumread - - - - -

spectro/illumread

Summary

- 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 spotread should be used instead.)
-

Usage Summary

- illumread [-options] - illuminant.sp
- -v + + + illumread + + + + +

spectro/illumread

Summary

+ 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 spotread should be used instead.)
+

Usage Summary

+ illumread [-options] + illuminant.sp
+ -v              - - Verbose mode
- -S -              - Plot the readings in a graph window.
- -c comport
+ -S +              + Plot the readings in a graph window.
+ -c comport            Set - - COM port, 1..4 (default 1)
-
+ -N                    Disable - - initial calibration of instrument if possible
- -H -              -       Use high resolution spectrum mode - (if available)
+ + initial calibration of instrument if possible
+ -H +              +       Use high resolution spectrum mode + (if available)
-Y r                  - - Set refresh measurement mode
- -W n|h|x              Override - - serial port flow control: n = none, h = HW, x = Xon/Xoff
- -T + + serial port flow control: n = none, h = HW, x = Xon/Xoff
+ -T                    - - Test mode - restore & save measurements to
+ + Test mode - restore & save measurements to
                        - - *_i.sp, *_r.sp, *_p.sp, *_mpir.sp, *_cpir.sp files
- -D [level] -            - Print debug diagnostics to stderr
- + -D [level] +            + Print debug diagnostics to stderr
+ illuminant.sp         File - - to save measurement to
-
-

Usage Details and Discussion

- illumread 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 FWA compensation. 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.
-
- The -v flag causes extra information to be - printed out during chartread operation.
-
- The -S 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.
-
- The instrument is assumed to communicate through a - USB or serial communication port, and the initial port can be - selected with the -c option, if the instrument is not - connected to the first port. If you invoke illumread 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.
-
- -N 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 -N - 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.
-
- The -H - option turns on high resolution spectral mode, if the instrument - supports it. See Operation of particular - instruments for more details.
-
- The -Y r - 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.
-
- The -W n|h|x - parameter overrides the default serial communications flow control - setting. The value n turns - all flow control off, h - sets hardware handshaking, and x - sets Xon/Xoff handshaking. This commend may be useful in workaround - serial communications issues with some systems and cables.
-
- The -T flag invokes the test mode. In test - mode the three measurements are saved to files illuminant_i.sp - (Illuminant spectrum), illuminant_r.sp (Illuminant - off paper spectrum), and illuminant_p.sp (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 illuminant_mpir.sp + + to save measurement to
+
+

Usage Details and Discussion

+ illumread 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 FWA compensation. 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.
+
+ The -v flag causes extra information to be + printed out during chartread operation.
+
+ The -S 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.
+
+ The instrument is assumed to communicate through a + USB or serial communication port, and the initial port can be + selected with the -c option, if the instrument is not + connected to the first port. If you invoke illumread 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.
+
+ -N 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 -N + 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.
+
+ The -H + option turns on high resolution spectral mode, if the instrument + supports it. See Operation of particular + instruments for more details.
+
+ The -Y r + 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.
+
+ The -W n|h|x + parameter overrides the default serial communications flow control + setting. The value n turns + all flow control off, h + sets hardware handshaking, and x + sets Xon/Xoff handshaking. This commend may be useful in workaround + serial communications issues with some systems and cables.
+
+ The -T flag invokes the test mode. In test + mode the three measurements are saved to files illuminant_i.sp + (Illuminant spectrum), illuminant_r.sp (Illuminant + off paper spectrum), and illuminant_p.sp (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 illuminant_mpir.sp (Measured paper under illuminant spectrum) and illuminant_cpir.sp - - (Computed paper under illuminant spectrum) will be saved.
-
- The -D 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.
-
- The illuminant.sp is the name of the file to save the - resulting illuminant spectrum to. The format used is .sp.
-
-

- Unlike the other measurement utilities, illumread 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.
-
- It will display a menu:
-
- Press 1 .. 6
- 1) Measure direct illuminant
- 2) Measure illuminant reflected from paper
- 3) Measure paper
- 4) Select another instrument, Currently 1 'usb:/bus4/dev2/ - (GretagMacbeth i1 Pro)'
- 5) Compute illuminant spectrum, average result with 0 previous - readings & save it
- 6) Compute illuminant spectrum from this reading & save result
- 7) Exit
-
- There are three measurements to be made, after which the illuminant - can be computed and saved. Before each measurement, the instrument - may need calibrating.
-
- 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.
-
- 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.
-
- 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 DTP41 would be suitable - instruments, as long as they are not fitted with UV filters.
-
- 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.
-
- The first measurement 1), - is to use either the ambient or emissive measurement mode to measure - the illumination directly.
-
-

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 spotread -S to - check that the reflection characteristic is close to flat.]
-
- Measuring Ambient

-
- The second measurement 2), - is to measure the illuminant after it has reflected from the paper.
-
-

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.
-
- Measuring via
- Paper

-
- The third measurement 3), - is to measure the paper directly using the instrument reflective - mode measurement.
-

- If a different instrument is needed, use 4) to select from the available instruments attached - to your computer.
-
- Once these three measurements have been made, then the illuminant - readings spectrum can be computed and save using 6), or a series of readings can - be made with each reading being averages with the previous readings - before saving it by using 5). - 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.
-
- 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).
-
-
- Illumread can then be terminated using 7).
-
-
-
-
-
-
-
-
-
-
-
- - + + (Computed paper under illuminant spectrum) will be saved.
+
+ The -D 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.
+
+ The illuminant.sp is the name of the file to save the + resulting illuminant spectrum to. The format used is .sp.
+
+

+ Unlike the other measurement utilities, illumread 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.
+
+ It will display a menu:
+
+ Press 1 .. 6
+ 1) Measure direct illuminant
+ 2) Measure illuminant reflected from paper
+ 3) Measure paper
+ 4) Select another instrument, Currently 1 'usb:/bus4/dev2/ + (GretagMacbeth i1 Pro)'
+ 5) Compute illuminant spectrum, average result with 0 previous + readings & save it
+ 6) Compute illuminant spectrum from this reading & save result
+ 7) Exit
+
+ There are three measurements to be made, after which the illuminant + can be computed and saved. Before each measurement, the instrument + may need calibrating.
+
+ 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.
+
+ 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.
+
+ 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 DTP41 would be suitable + instruments, as long as they are not fitted with UV filters.
+
+ 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.
+
+ The first measurement 1), + is to use either the ambient or emissive measurement mode to measure + the illumination directly.
+
+

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 spotread -S to + check that the reflection characteristic is close to flat.]
+
+ Measuring Ambient

+
+ The second measurement 2), + is to measure the illuminant after it has reflected from the paper.
+
+

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.
+
+ Measuring via
+ Paper

+
+ The third measurement 3), + is to measure the paper directly using the instrument reflective + mode measurement.
+

+ If a different instrument is needed, use 4) to select from the available instruments attached + to your computer.
+
+ Once these three measurements have been made, then the illuminant + readings spectrum can be computed and save using 6), or a series of readings can + be made with each reading being averages with the previous readings + before saving it by using 5). + 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.
+
+ 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).
+
+
+ Illumread can then be terminated using 7).
+
+
+
+
+
+
+
+
+
+
+
+ + -- cgit v1.2.3