NUM

Description

Parameters

Parameter descriptions

FILE

Specifies the name of the PCIDSK file to examine.

DBIC

Specifies the input raster channels to examine.

Ranges of channels or segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}. When you are not specifying a range in this way, only 48 numbers can be specified explicitly.

DBIW

Specifies the raster window (Xoffset, Yoffset, Xsize, Ysize) that is read from the input layers. If this parameter is not specified, the entire layer is used by default.

Xoffset, Yoffset define the upper-left starting pixel coordinates of the window. Xsize is the number of pixels that define the window width. Ysize is the number of lines that define the window height.

This parameter cannot be defaulted.

REPORT

Specifies where to direct the generated report.

Available options are:

• TERM: generates a report on the terminal (default)
• DISK: generates a report on file "IMPRPT.LST"
• OFF: turns off report generation
• <filename>: appends a report to the specified file

Details

NUM prints a numeric window (DBIW) of input channels (DBIC) to an output device. A numeric window shows the actual numeric gray level values at each pixel. Gray level values depend on the type of data that the channel contains.

The input window (DBIW) consists of 4 values: horizontal and vertical offsets from the upper-left corner of the image, and horizontal and vertical window size.

A report device (REPORT) must be selected. If the report device is "OFF", it defaults to the terminal output. When the report is directed to the terminal, it is printed on the user's terminal, one page at a time. If the report consists of more than one page, the user is prompted to either view the next page, scroll the remaining pages ([G]o), or exit to the command level (e[X]it).

The number of pixels printed per line depends on the screen or paper width and the type of image data printed. For 8-bit data, this is 17 values per line. Window sizes are adjusted to fit screen or paper. This adjustment may vary between channels, if data types differ.

Example

Print a 16 x 8 numeric window (offset 10 by 10) of channel 1 (TM band 1 - blue/green) of the demo file "irvine.pix".

EASI>file	=	'irvine.pix'	! input file name
EASI>dbic	=	1
EASI>dbiw	=	10,10,16,8	! input image window
EASI>report	=		! print report on terminal

EASI>RUN num

 NUM Database Image Numeric Window  

 irvine.pix                       [S 11PIC   512P   512L] 
 1 [ 8U]: MCD    0.45 - 0.52 micrometres: Blue-Green      

 Offset: (   10,   10)  Size: (   16,    8)

      1   1   1   1   1   1   1   1   1   2   2   2   2   2   2   2
      1   2   3   4   5   6   7   8   9   0   1   2   3   4   5   6
   +---------------------------------------------------------------
 11| 57  56  58  55  53  56  61  59  57  56  58  60  58  59  59  60
 12| 56  54  56  55  57  55  59  59  56  58  58  56  55  58  59  59
 13| 54  55  54  56  60  57  57  58  55  61  57  56  56  56  57  58
 14| 54  55  54  56  56  58  58  56  56  57  58  59  57  56  55  59
 15| 57  58  60  58  55  56  56  58  55  54  57  58  57  56  59  61
 16| 57  58  63  63  57  58  58  57  56  57  55  56  56  56  62  60
 17| 55  57  59  62  58  57  57  56  57  59  58  57  58  58  62  61
 18| 61  58  54  59  61  57  54  56  56  56  60  61  58  58  63  64