User's Guide

DSPMNR

Display the contents of a minor frame file.

Function:

Displays the contents of a minor frame file. The contents are printed to the terminal, the line printer, or a disk file. The minor frame file is a label services file containing the HRPT minor frame data associated with an AVHRR LAS image.

Parameters:

IN
Input image. The name of the AVHRR LAS image for which the associated minor frame file will be displayed. The file extension for the minor frame file is assumed to be ;MNR.

SL(1)
Starting line. The line number at which reporting will begin. See User Note 2.

NL(--)
Number of lines. Number of lines of minor frame data to display. If the end of the minor frame file is encountered before NL lines of data have been displayed, processing will terminate. By default, the remainder of the file starting at SL will be displayed.

LISTOPT("ON","ON","ON","ON","ON","ON","ON")
List options. Display of the following fields in the minor frame file may be turned "ON" or "OFF" in the resulting report:

   Frame Sync Data
   ID Data
   Time Code Data
   Telemetry Data
   Internal Target Data
   Space-Scan Data
   Sync Delta Data

PRINT(TERM)
Output destination. The destination of the output.

  = 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> dspmnr in=africa sl=500

    Minor frame data starting at line 500 from the minor frame file AFRICA;MNR are read, formatted, and displayed to the user's terminal. Processing will continue until all remaining lines in the file have been displayed. All fields in each line are reported.

  2. LAS> dspmnr in=samerica sl=200 nl=10 listopt=(off,off,off,off,on,off,off) print=lp

    Lines from the minor frame file SAMERICA;MNR are read, formatted, and output to the printer. Data from lines 200 through 209 will be displayed. Only internal target data will be displayed for each line.

Description/Algorithm:

The appropriate lines from the minor frame file are read, formatted into a report, and routed to the specified output destination.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [dspmnr-fatal] Fatal error encountered

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

  2. [dspmnr-lines] Invalid number of lines specified

    The specified number of lines to display is less than one. Check the values of SL and NL.

  3. [dspmnr-open] Error opening temporary file

    The temporary file used to route the output to the specified destination cannot be opened. Verify write permissions in the current directory.

  4. [dspmnr-ddrnl] DDR not available / NL not specified

    If NL is not specified, NL will be determined by reading the image's associated Data Descriptor Record (DDR). The associated DDR is expected to have the same root file name as the minor frame file and a suffix of ;DDR. Make one of the two sources for NL available.

  5. [dspmnr-lsread] Error reading minor frame file

    An error occurred reading the minor frame file. The file has been corrupted. Regenerate the minor frame file using AVHRRIN.

User Notes:

  1. For more information on the minor frame consult:

       a) Kidwell, Katherine B. "NOAA Polar Orbiter Data Users
          Guide", Table 3.1.2.1-3, pp. 3-4 through 3-6.
       b) Levin Lauritson, Gary Nelson, Frank Porto, "NOAA Technical
          Memorandum NESS 107", "Data Extraction and Calibration of
          TIROS-N/NOAA Radiometers", Section 3.3.1., pp. 20 - 23.
    

  2. Processing will proceed from the SL line down through NL lines of minor frame data which was placed in the minor frame file in "North-up" order by AVHRRIN. SL and NL are relative to a "North-up" orientation of the image. They also refer to the line numbers relative to the original archive image. For example, if the original AVHRR archive image was a 2000-line ascending image, AVHRRIN will "flip" the image and the minor frame into "North-up" orientation. DSPMNR with SL=1 and NL=100 will display the northernmost 100 lines of minor frame data, starting at the north and moving south. If an AVHRR LAS image was windowed from the original archive image at (300 1 1000 2048), to display the LAS image's top 100 lines of minor frame data, SL would be 300 and NL would be 100.