NUM

Description

Parameters

num(file, dbic, dbiw)

Parameter descriptions

FILE

Specifies the name of the PCIDSK file to examine.

DBIC

Specifies the input raster channels to examine.

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.

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

from pci.num import num

file	=	'irvine.pix'	# input file name
dbic	=	[1]
dbiw	=	[10,10,16,8]	# input Image Window

num( file, dbic, dbiw )

 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