User's Guide

DSPDDR

Displays the contents of the input DDR file.

Function:

Displays the contents of the input DDR file. The contents may be displayed to the terminal, line printer, disk file, or to an ASCII project parameter file.

Parameters:

IN

Input image. This is the name of the image for which the DDR information will be displayed. Window or band options are not allowed.

OUTPPF(--)

Output project parameter file. A project parameter file containing all of the information from IN's DDR.

PRINT(TERM)

Output destination. The destination of the output DDR information. PRINT is ignored if OUTPPF is specified.

  = --:        No Report
  = 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 a disk file named "filename".

BANDS(--)

Band number(s). The associated band information to be displayed. By default, information for all bands in the image will be displayed.

Examples:

1. LAS> dspddr in=test print=term bands=(1,2)

   DSPDDR will read the contents of the DDR file that is associated with the image TEST;IMG. The data that is associated with the image as a whole and data that is associated with bands one and two will be printed to the terminal.

2. LAS> dspddr in=test print=(term,lp) bands=2

   DSPDDR will read the contents of the DDR file that is associated with the image TEST;IMG. The data that is associated with the image as a whole and data that is associated with the band two will be printed to the terminal and the line printer specified by the global $PRINTER.

3. LAS> dspddr in=test outppf=project bands=1

   DSPDDR will read the contents of the DDR file that is associated with the image TEST;IMG. The data that is associated with the image as a whole and data that is associated with band one will be written to the project parameter file PROJECT;PPF.

Description/Algorithm:

DSPDDR retrieves the contents of the DDR file. The fields associated with the image as a whole and the fields associated with each band specified are displayed to the specified device(s).

Nonfatal Error Messages:

None.

Fatal Error Messages:

1. [dspddr-bands] Invalid band number

   A band number was specified that was greater than the number of bands in the image.

2. [dspddr-fatal] Fatal error encountered

   A fatal error was encountered during processing. Processing is terminated. The message that is displayed immediately preceding this error message is the specific error that was encountered.

3. [dspddr-alloc] Error allocating dynamic memory

   An error occurred allocating memory. Rerun, and if the error persists, contact the system administrator.

User Note:

1. Related modules are EDITDDR and GETPARM.

2. Refer to GETPARM for information regarding the format of a project parameter file.

3. Displaying the output to a project parameter file is useful for getting information from a DDR into a procedure PDF (via GETPARM) for use as a parameter or for procedure control.