User's Guide

DSPADDR

Display the AVHRR Data Descriptor Record (ADDR)

Function:

Displays the information in an AVHRR LAS image's associated AVHRR Data Descriptor Record (ADDR). A formatted report can be routed to the user's terminal, the line printer, or a specified file.

Parameters:

IN
Input image. The name of the image for which the ADDR information will be displayed.

PRINT(TERM)
Output destination. The destination of the formatted report of information from the AVHRR Data Descriptor Record (ADDR).

  = TERM:        Terminal.  Output is sent to the
                 user's terminal.
  = LP:          Line printer.  Output is sent to the
                 printer defined by $PRINTER.
  = Filename:    User-supplied filename.  Output is
                 sent to the user-supplied file with
                 the extension ;PRT.

Example:

  1. LAS> dspaddr in=africa

    The AVHRR Data Descriptor Record (ADDR) from the AFRICA image is read, formatted, and displayed to the user's terminal.

Description/Algorithm:

Information from the image's associated ADDR is read, formatted into a report, and routed to the specified output destination. Included in the report are satellite information such as the satellite number, image-specific information such as the number of lines and samples, satellite attitude correction coefficients, image corner coordinates, ephemeris data, and dropped line information.

Nonfatal Error Message:

  1. [dspaddr-gaps] Too many line gaps found; Reset to maximum

    A maximum of MAX_GAPS gaps of dropped lines will be included in the report, even though there were more gaps described in the image's associated dropped line file.

  2. [dspaddr-open] Error opening the dropped line file

    The dropped line file associated with the image could not be opened or did not exist. No valid dropped line information will be written to the report.

  3. [dspaddr-read] No corresponding line number or number of missed lines

    The dropped line file associated with the image had an invalid record. Dropped line gaps read thus far will be included in the report.

Fatal Error Message:

  1. [dspaddr-fatal] Fatal error encountered

    The error message displayed immediately preceding this message is the specific error encountered. Processing is terminated.

  2. [dspaddr-open] Error opening temporary file for fileutil

    An error occurred opening the temporary report file. Check the permissions on the current directory.

User Notes:

    None.