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.
2019-09-06 Walt Bunch - IDS-7922 - Initialized some variables. Replaced sprintf
calls. Cleaned up -Wall warnings.
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: