User's Guide

MULLIINFO

Return scene information from the composite date log file

Function:

Return scene information from the composite date log file needed to reverse the effects of illumination correction applied during calibration.

Parameters:

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.

Examples:

  1. LAS> mulliinfo datelog="us_239245;log" periods(="232238","239245") sceneptlist=@sceneptlist sceneidlist=@sceneidlist ndays=@ndays

    The date log file "us_239245;log" is read. The information relevant to periods "232238" and "239245" is returned in the appropriate parameters.

Description/Algorithm:

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.

Nonfatal Error Messages:

  1. [mullii-warn] Nonfatal error encountered

    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.

  2. [mullii-clos] Error closing input file <XXXXXX>

    An error occurred closing the input file. Contact the system administrator if this error persists.

Fatal Error Messages:

  1. [mullii-fatal] Fatal error encountered

    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.

  2. [mullii-open] Error opening input file <XXXXXX>

    An error occurred while trying to open the input date log file. Ensure that the file exists with the proper permissions and rerun.

  3. [mullii-read] Error reading line <XX> in input file

    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.

  4. [mullii-rparm] Error returning parameter <XXXXXX> to TAE

    An error occurred while trying to return information to TAE. Contact the system administrator if this error persists.

  5. [mullii-indx] Invalid scene index specified

    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.

  6. [mullii-days] Maximum number of days (<XX>) exceeded

    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.

  7. [mullii-form] Error determining log file format

    The log file format was not determined. Refer to the sample log files ('short' or 'long' format) to determine their correct format.

User Notes:

  1. Part of the MULLI software.

  2. The date band log file is generated at the time the composite is generated. For a sample input date band log file, see the file 'us_232245;log' ('long' format), or the file '1992p19;log' ('short' format) stored under CVS as part of the MULLI module.