NUMWRIT -- Write Image Data to Text File

Writes image data grey-level values from database image channel(s) to a text file.

See Also: NUMREAD, NUM, IMAGEWR

PARAMETERS

NUMWRIT is controlled by the following global parameters: 

Name     Prompt                                  Count     Type
FILE     Database File Name                      1-64      Char
DBGEO    Database Georeferencing Segment         0-1       Int
DBIC     Database Input Channel                  1-1024    Int
MASK     Area Mask (Window or Bitmap)            0-4       Int
NUMFORM  Output Form: COORD/DATA/GEOCOORD        4-12      Char
TFILE    Text File                               1-64      Char

FILE

Specifies the name of the PCIDSK image file. 

 EASI>FILE="filespec"

DBGEO

Optionally specifies the georeferencing segment. This parameter is required if the output coordinates desired are in georeferenced units rather than pixel and line. If NUMFORM is not "GEOCOORD", pixel and line coordinates are used in writing the output file. 

 EASI>DBGEO = i                 | Georeferencing segment
 EASI>DBGEO =                   | Defaults to 1

DBIC

Specifies the database image channel(s) whose grey values are to be written to the output text file. 

 EASI>DBIC=i

MASK

Specifies the area of interest in the input channel(s) that is to be written to the text file (TFILE). This can be one of the following: 

 EASI> MASK = xoff,yoff,xsize,ysize | process rectangular window
 EASI> MASK = b                     | process only under bitmap
                                      stored in segment b
 EASI> MASK =                       | process entire extent of
                                      channels

NUMFORM

Specifies the format in which image data will be stored in the text file. Image data can be written in one of three formats: coordinate, georeferencing, or data. 

 EASI>NUMFORM="COORDn"   | coordinate format, n sets/line
 EASI>NUMFORM="COORD"    | coordinate format, default 1 pixel/line
 EASI>NUMFORM="GEOCOORDn"| georeferenced coordinate format, n
                           sets/line
 EASI>NUMFORM="GEOCOORD" | georeferenced coordinate format, 1
                           set/line 
 EASI>NUMFORM="DATAn"    | data format, n values/line
 EASI>NUMFORM="DATA"     | data format, default 1 pixel/line
For coordinate (COORD) format, the text file contains two values for each pixel: database x-position (pixel) and database y-position (line), and is followed by grey level value(s) pertaining to each input channel(s) (in pixel-interleave mode). The user can specify the number of pixels that will be output on each line of text using the "COORDn" form. For example, if n=2 (i.e., "COORD2"), then 2 pixels (6 values) will be output on each line for one input channel. If number of input channels is four, and n=2 (i.e., "COORD2"), then four pixels (x,y coordinate and two grey level values) will be output on each line for a total 12 columns. If no value is specified, then by default 1 pixel will be output per line.

For georeferenced coordinate (GEOCOORD) format, the content of the text file is similar to that of the COORD format except that the (x,y) position is expressed in georeferenced units. The user can specify the number of pixels that will be output on each line of text using the "GEOCOORDn" form. For example, if n=2 (i.e., "GEOCOORD2"), then 2 pixels (6 values) will be output on each line, if DBIC is equal to one. If no n value is specified, then by default 1 pixel will be output per line for 8-bit, 16-bit or 32-bit channels.

For data ("DATA") format, the text file will contain a grey level value for each pixel (one grey level value for each input channel, DBIC). The user can specify the number of pixels that will be output on each line of text using the "DATAn" form. For example, if n=2 (i.e., "DATA2"), then 2 pixels (2 values) will be output on each line. If no n value is specified, then by default 1 pixel will be output per line.

TFILE

Specifies the name of the text file to which the image channel data are written. 

 EASI>TFILE="textfile name"
The text file must not exist before running the NUMWRIT program.

DETAILS

NUMWRIT transfers image data from image channels (DBIC) on a database file (FILE) to the text file (TFILE). The image grey level values are transferred in a format that can be read by other third-party programs, such as SAS, DBASE, or LOTUS.

The MASK parameter specifies the area within the input channel(s) from which to write grey-level values into the text file (TFILE). If a single value is specified, then this value points to a bitmap segment which defines the area to be processed. When four values are specified, these values define the x,y offsets and x,y dimensions of a rectangular window within the image to be processed. If MASK is defaulted, the entire database is processed and is written to the text file.

If more than one input channel is specified, the program writes the data into the text file in pixel interleave form (BIP).

Text data can be written in one of three different formats: coordinate (NUMFORM="COORD") or geocoordinate (NUMFORM="GEOCOORD") or data (NUMFORM="DATA").

EXAMPLE

The image file TEST.PIX has the following data in the upper left 10 pixel by 7 line window in channel 1: 

 Offset: (    0,    0)  Size: (   10,    7)

          1   2   3   4   5   6   7   8   9  10
       +---------------------------------------
      1| 64  64  64  64  64  64  64  64  64  64
      2|192 192 192 192 192 192 192 192 192 192
      3| 64  64  25  76 128 179 230  64  64  64
      4|128 128  25  76 128 179 230 128 128 128
      5|128 128  25  76 128 179 230 128 128 128
      6|192 192  25  76 128 179 230 192 192 192
      7|192 192  25  76 128 179 230 192 192 192
Create a text file COORD.TXT with image data in coordinate format with 5 pixels per text line: 

 EASI>FILE="TEST.PIX"
 EASI>DBIC= 1
 EASI>MASK=0,0,10,7             | defines the upper left 10 x 7
                                  region
 EASI>NUMFORM="COORD5"          | 5 values per text line
 EASI>TFILE="COORD.TXT"
 EASI>RUN NUMWRIT
The following text is written to the text file COORD.TXT: 

 1  1  64   2   1  64   3   1  64   4   1  64   5   1  64
 6  1  64   7   1  64   8   1  64   9   1  64  10   1  64
 1  2 192   2   2 192   3   2 192   4   2 192   5   2 192
 6  2 192   7   2 192   8   2 192   9   2 192  10   2 192
 1  3  64   2   3  64   3   3  25   4   3  76   5   3 128
 6  3 179   7   3 230   8   3  64   9   3  64  10   3  64
 1  4 128   2   4 128   3   4  25   4   4  76   5   4 128
 6  4 179   7   4 230   8   4 128   9   4 128  10   4 128
 1  5 128   2   5 128   3   5  25   4   5  76   5   5 128
 6  5 179   7   5 230   8   5 128   9   5 128  10   5 128
 1  6 192   2   6 192   3   6  25   4   6  76   5   6 128
 6  6 179   7   6 230   8   6 192   9   6 192  10   6 192
 1  7 192   2   7 192   3   7  25   4   7  76   5   7 128
 6  7 179   7   7 230   8   7 192   9   7 192  10   7 192
Create a text file using the "data" format, with 10 grey values per line: 

 EASI>FILE="TEST.PIX"
 EASI>DBIC= 1
 EASI>MASK=0,0,10,7
 EASI>NUMFORM="DATA10"          | 10 values written per ine
 EASI>TFILE="DATA.TXT"
 EASI>RUN NUMWRIT
The following text is written to the text file DATA.TXT: 

   64  64  64  64  64  64  64  64  64  64
  192 192 192 192 192 192 192 192 192 192
   64  64  25  76 128 179 230  64  64  64
  128 128  25  76 128 179 230 128 128 128
  128 128  25  76 128 179 230 128 128 128
  192 192  25  76 128 179 230 192 192 192
  192 192  25  76 128 179 230 192 192 192
About PCI Help Gateway