Return scene information from the composite date log file
Return scene information from the composite date log file needed to reverse the effects of illumination correction applied during calibration.
- DATELOG
- Date log file. The file containing the composites date band information ('short' or 'long' format). 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).
- SCENEPTLIST
- Scene pointer listing. Refer to the description/algorithm section for detailed information regarding the information returned in this parameter.
- SCENEIDLIST
- Scene id listing. Refer to the description/algorithm section for detailed information regarding the information returned in this parameter.
- NDAYS
- Number of days. The number of entries returned in SCENEIDLIST is returned in this parameter.
The date log file "us_239245;log" is read. The information relevant to periods "232238" and "239245" is returned in the appropriate parameters.
Each entry in the date log file is read.
For date log files in the 'long' format the following comments apply: - If the date index is "-1", the scene was not used in the composite and should not be considered. - If the period name of the entry was not specified in PERIODS, the entry should not be considered (it's not within the period of interest). For date log files in the 'short' format the following comments apply: - All entries in the log file were used in the composite (all entries are assumed to be within the periods specified in PERIODS).A list of all the scenes used in the composite is compiled and returned in SCENEIDLIST. A date band value (band generated by the compositing process to designate which image each pixel in the composite came from) is used as an index into SCENEPTLIST, and SCENEPTLIST is used as an index into DATEIDLIST. For example, if the date band value is 10, and SCENEPTLIST[10] is equal to 3, then SCENEIDLIST[3] contains the scene id referred to as scene 10 in the date band.
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.
An error occurred closing the input file. Contact the system administrator if this error persists.
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 error occurred while trying to open the input date log file. Ensure that the file exists with the proper permissions and rerun.
An error occurred while trying to read the input date log file. Make certain the file is properly formatted, and rerun. See User Note 2 for more information on the date log file format.
An error occurred while trying to return information to TAE. Contact the system administrator if this error persists.
A scene number as specified in the date band log file is invalid. Examine the scene number values in the specified date band log file.
The number of days used in the composite has exceeded the expected maximum number. Verify the number of days spanned by the composite being processed.
The log file format was not determined. Refer to the sample log files ('short' or 'long' format) to determine their correct format.