User's Guide

DSPRWT

Displays the contents of a resampling weight table file

Function:

Displays the contents of a resampling weight table file. It provides the options of printing the information on the line printer, on the user's terminal, or sending it to a text file.

Parameters:

INRWT
Input resampling weight table file. The input resampling weight table file to be printed.

PRINT(TERM)
Output destination. The output destination of the resampling weight table report. The available output destinations are:


  = 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".

Examples:

  1. LAS> dsprwt testrwt term

    The contents of the resampling weight table file TESTRWT are displayed on the terminal.

  2. LAS> dsprwt inrwt=rwt.out print=(term,lp)

    The contents of the resampling weight table file RWT.OUT are displayed on the terminal and printed on a printer.

Description/Algorithm:

The parameters are read and the resampling weight table file is opened and read. DSPRWT dumps each table contained in the file to the output destination specified by PRINT.

Nonfatal Error Messages:

    None.

Fatal Error Message:

  1. [dsprwt-fatal] Fatal error encountered

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

User Notes:

  1. Resampling weight table files are binary files in label services form and may be produced by the RTABLE function. Their format is given in the LAS programmer's manual.

  2. Each resampling weight table contains 33 records. Each record contains table entries for 1/32 of a pixel; that is, both endpoints are included (thus 33 records instead of 32).