Help for LIST

 PURPOSE:
 LIST will give a numerical listing of a VICAR dataset.
 It offers a large assortment of print formats and input data formats.
 All parameters except INP are optional. Only the first four characters of
 string parameters (other than INP) are checked by the program.
 Caution should be used in defaulting the SIZE parameter as this will result
 in the entire picture being listed. For a 900 x 900 byte picture, this
 would tie up the line printer for 30 minutes.

 If the keyword DUMP is specified, the output may be a tape data set.
 If DUMP is not specified, the data set is listed in vertical strips
 30 pixels wide.  Since this will generally result in multiple
 passes through the data, the picture should be on a disk data set.
 LIST can handle unlabeled files if the parameter INSIZE is given.  The
 input file format and organization is taken from the FORMAT and ORG
 parameters, if present.

 The maximum record size (number of samples * pixel size) that LIST
 can handle is 200,000 bytes.  If you try to list even just a part
 of an image that is bigger than 200,000 bytes, you will get an error.

 EXECUTION:
    The following is the execution statement for LIST:
            LIST  INP  SIZE  PARAMS
 where INP, SIZE, and PARAMS are parameters discussed in their
 respective parameter section in TUTOR mode.
 TIMING:                   None available for the VAX

 WRITTEN BY:               Gary Yagi          01/10/77
 COGNIZANT PROGRAMMER:     Bob Deen

 REVISIONS: 

  1977-01-10 Gary Yagi - Initial version
  1982-12-20 Lucas Kamp - Conversion to VAX
  1983-10    ANON - Renamed from PRNT to avoid confusion with the subroutine PRNT
  1984-01    Lucas Kamp - Changed 64 (EBCDIC space) to 32 (ASCII)
  1984-11    Lucas Kamp - Fixes to reduce QPRINT line length & supress "NO LABELS" msg.
             (Both should be temporary!)
  1985-02-15 Ray Stagner - Conversion to VICAR2
  1985-04-25 Ray Stagner - Change DCODE from 9 to 10 for complex data type to
             be consistent with other VICAR programs
  1987-04    Steve Pohorsky Deleted nonfunctional PRINT and SHIFT parameters.
  1987-06-18 Bob Deen - Major revisions; added 3D file capability and reading of
             unlabeled files.
  1990-02    Bob Deen - Rewritten in C with Unix compatibility; removed all sublib 
             references (outcon, prnt, etc.).
  1995-05    Barbara McGuffie - Corrected error with hex dump option.  Disables hex
             dump for DOUB/COMP.  FR 79143                       */
  1995-11    Barbara McGuffie - Added MEMCPY in MOVX and removed pointer moves FR 87132. 
             Also, modified tstlist.pdf to use cform rather than c.
  1998-06    TIH - Added check for INSIZE parameter when file is not
             labeled. Changed tstlist.pdf to conform to UNIX
             (see AR-9635)                                  
             Added NDIGITS parameter to specify the precision
             used to display real numbers (REAL, DOUB, COMP)
  2000-10-06 Amy Chen - Added stdio.h header file
  2017-03-29 Walt Bunch - Added NOUSRTIM param to help automated regression testing.


PARAMETERS:


INP

Input dataset

SIZE

Image size (See HELP FORMAT)

BANDS

Image band size (See HELP FORMAT)

SL

Integer - Starting Line

SS

Integer - Starting Sample (See HELP FORMAT)

SB

Integer - Starting Band (See HELP FORMAT)

NL

Integer - Number of Lines

NS

Integer - Number of Samples (See HELP FORMAT)

NB

Integer - Number of Bands (See HELP FORMAT)

FORMAT

Data format Valid: HEX,BYTE,HALF WORD,FULL,REAL,REAL4, REAL8,DOUBLE,COMPLEX

LINC

Line increment

SINC

Sample increment (See HELP FORMAT)

BINC

Band increment (See HELP FORMAT)

INCREMEN

Line and sample increment

DUMP

Record dump? Valid: DUMP.

ZEROES

Print zeroes? Valid: ZEROES.

NOEJECT

Repeat header? Valid: NOEJECT.

SPACE

Line spacing

NDIGITS

Number of significant digits.

DISPLAY

Display spacing? Valid: DISPLAY.

NOFEED

Suppress form feeds? Valid: NOFEED

NOUSRTIM

Suppress username and datetime? Valid: NOUSRTIM

ORG

Output organization Valid: BSQ,BIL,BIP.

INSIZE

(nl,ns,nb) of input if unlabeled

See Examples:


Cognizant Programmer: