Reverse the effects of illumination correction
Reverse the effects of illumination correction applied to an image during calibration. This capability is necessary because if a product was calibrated with illumination correction, it should not be later atmospherically corrected without first reversing the effects of illumination correction.
- IN
- Input image. A LAS image of containing AVHRR channel 1 and 2 data respectively. These bands must contain byte data and must be scaled using "US" scaling.
- DATEBAND
- Composite date band. The 'date band' generated during the creation of the composite. The band signifies which acquisition image each pixel in the composite came from. This image is expected to be the same size and in the same space as the composite specified by IN.
- SCALE
- Scaling technique used to generate the composite.
US US scaling technique
- DATELOG
- Date log. The log file associated with the DATEBAND image which specifies the scenes used to generate the composite. See User Note 2 for more information.
- PERIODS
- Period name(s). The period names that were included in the composite. For example, '008014' for a US composite (julian days 008 through 014). NOTE: This parameter is not used if the date log file specified in DATELOG is a 'short' format file (all entries in the date log file are assumed to be within the period of interest).
- OUT
- Output image. Image containing AVHRR channel 1 and 2 data without the effects of illumination correction. This image will be the same size and in the same space as the composite specified by IN. This image will always contain BYTE data, with "US" scaling applied, and will always be compressed.
The user has requested to process bands 1 and 2 of a composite (AVHRR channels 1 and 2). The date band for the composite resides in band 10 of 'us_098'. "US" scaling will be applied to the input and the output image. The date log file to be used is 'us_098;log' (see MULLIINFO for more information). The period to consider within 'us_098;log' is "098104".
The effect of illumination correction on calibration coefficients for optical bands can be expressed as follows:C_with_illum = C_without_illum * d * d / cos z
where C_with_illum = the new Calibration coefficient with illumination correction C_without_illum = the old Calibration coefficient without illumination correction d = distance between the sun and the earth z = solar zenith angle
Consequently, to 'undo' the effects of illumination correction, the following equation needs to be applied:
C_without_illum = C_with_illum * cos z / (d * d)
A nonfatal error was encountered during processing. The error message that is displayed immediately preceding this message is the specific error that was encountered. Processing will continue.
A fatal error was encountered during processing. Processing is terminated. The error message that is displayed immediately preceding this message is the specific error that was encountered.
An input image was not specified with the correct number of bands. Examine the input image specification and rerun.
The number of input images was not specified correctly. Examine the input image specification and rerun.
An error occurred while trying to allocate memory. Contact the system administrator if the error persists.
A date band mismatch has occurred. Ensure that the date band image and date band log file coincide and rerun.
The input image specified must be BYTE data. Specify an image with BYTE data and rerun.
The number of lines and samples specified within the bands of IN and DATEBAND must be the consistent (same number of lines/samples in each band). Rerun with the correct IN and DATEBAND specification.