IIIC -- Database to Database Image Transfer

Transfers image data in up to 1024 image channels between two database files or within one database file.

Progress of this program can be monitored. See MONITOR section.

See Also: III, GDB, SCALE

PARAMETERS

IIIC is controlled by the following global parameters: 

Name     Prompt                                  Count     Type
FILI     Database Input File Name                1-64      Char
FILO     Database Output File Name               0-64      Char
DBIC     Database Input Channel List             1-1024    Int
DBOC     Database Output Channel List            1-1024    Int
DBIW     Database Input Window                   0-4       Int
DBOW     Database Output Window                  0-4       Int

FILI

Specifies the name of the GDB supported image file from which image data is to be read. 

 EASI>FILI="filespec1"

FILO

Specifies the name of the GDB supported file to which image data is to be written. FILO can be the same as FILI. FILO must exist before running III. If FILO is not specified, then it defaults to FILI. 

 EASI>FILO="filespec2"

DBIC

Specifies the list of input channels to be read from file FILI. 

 EASI>DBIC = i,j,k, ...

DBOC

Specifies the list of channels to be output to file FILO. 

 EASI>DBOC = i,j,k, ...
The total number of channels specified by DBIC must be equal to the total number of channels specified by DBOC.

If corresponding input and output channels are the same, then input and output windows (DBIW and DBOW) must not overlap.

DBIW

Specifies the image window to be read from input channels. 

 EASI>DBIW=Xoffset,Yoffset,Xsize,Ysize
 EASI>DBIW=                     | defaults to entire image

DBOW

Specifies the image window to be written to output channels. 

 EASI>DBOW=Xoffset,Yoffset,Xsize,Ysize
 EASI>DBOW=                     | defaults to entire image
Xsize and Ysize need not be the same for DBIW and DBOW. Scaling and mapping of images are done automatically.

If FILI = FILO, and DBIC, DBOC, DBIW and DBOW are selected in such a way so that the windows overlap, then unexpected results may occur.

DETAILS

IIIC transfers data from up to 1024 image channels (DBIC) on the input file (FILI) to up to 1024 image channels (DBOC) on the output file (FILO). Channel remapping is automatically performed.

It is essentially the same as the PACE task III, except that it may be used to read from, and write to any file formats supported by the GDB library.

The output database file (FILO) must exist before running IIIC. If it does not, the user must create it by running CIM. The output file and input file can be the same database file.

Any arbitrary rectangular window on the input file (DBIW) can be transferred to any arbitrary rectangular window on the output file (DBOW). Shrinking and/or zooming of image data happens automatically whenever the input window size does not match the output window size.

If an input channel is 32-bit real, and the output channel is 16-bit integer or 8-bit (byte), or if the input channel is 16-bit integer and the output channel is 8-bit, then data values may be truncated.

MONITOR

Program progress can be monitored by printing the percentage of completed processing in odometer fashion. A system parameter, MONITOR, controls this activity: 

EASI>MONITOR="ON"           | turn monitor ON  (default)
EASI>MONITOR="OFF"          | turn monitor OFF (recommended if
                            | running in batch/background mode)

EXAMPLE

Create a display sized (512 x 512) split-screen image from four 256 x 256 image channels. 

 EASI>FILI="name of 256 x 256 file"
 EASI>FILO="name of 512 x 512 file"
 EASI>DBOC=1                     | select output channel
 EASI>DBIW=                      | default to entire input window
 EASI>DBIC=1                     | select input channel
 EASI>DBOW=0,0,256,256           | select upper left quadrant of
                                 | output image
 EASI>RUN IIIC                   | transfer channel
 EASI>DBIC=2                     | re-select input channel
 EASI>DBOW=256,0,256,256         | select upper right quadrant of
                                 | output image
 EASI>RUN IIIC                   | transfer channel
 EASI>DBIC=3                     | re-select input channel
 EASI>DBOW=0,256,256,256         | select lower left quadrant of
                                 | output image
 EASI>RUN IIIC                   | transfer channel
 EASI>DBIC=4                     | re-select input channel
 EASI>DBOW=256,256,256,256       | select lower right quadrant of
                                 | output image
 EASI>RUN IIIC                   | transfer channel
Transfer data on image channels 1 through 1024 to image channels 1024 through 1 on the same image database file: 

 EASI>FILI="bigfile"
 EASI>FILO="bigfile"
 EASI>DBIC=1,-1024
 EASI>DBOC=1024,-1
 EASI>DBIW=
 EASI>DBOW=
Examples of valid channel range specifiers are: 

 EASI>DBIC=10,-15,200,-197,12,-8
 EASI>DBOC=10,-13,15,14,200,-196,195,1000,-1002
DBIC and DBOC expand to the following channel numbers: 

 in  = 10,11,12,13,14,15,200,199,198,197, 12, 11,  10,   9,   8
 out = 10,11,12,13,15,14,200,199,198,197,196,195,1000,1001,1002
Notice that both lists expand to the same number of channels (in this case 15 channels) and that duplicate channel numbers are allowed for input channels, but NOT for output channels.

About PCI Help Gateway