MIH -- PCI Tape to Database Transfer

Transfers image data from PCI-format magnetic tape to PCIDSK database file.

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

PARAMETERS

MIH is controlled by the following global parameters:

Name     Prompt                                  Count     Type
FILE     Database File Name                      1-64      Char
MTIC     Mag Tape Input Channel List             1-16      Int
DBOC     Database Output Channel List            1-16      Int
MTIW     Mag Tape Input Window                   0-4       Int
DBOW     Database Output Window                  0-4       Int
MTID     Mag Tape ID                             0-20      Char
STARTFIL Start File on Tape                      1         Int

FILE

Specifies filename of PCIDSK image database to receive output imagery from tape. The database file must exist prior to running MIH and would be created using CIM.

 EASI>FILE="filename"

MTIC

Specifies list of up to 16 8-bit image channels on PCI-format tape.

 EASI>MTIC=i,j,...,p

Ranges of channels can be specified with negative values. For example: {1,-4,10} is internally expanded to {1,2,3,4,10}.
Duplicate channels are NOT allowed.

DBOC

Specifies list of up to 16 image channels on PCIDSK database.

 EASI>DBOC=i,j,...,p

Ranges of channels can be specified with negative values. For example: {1,-4,10} is internally expanded to {1,2,3,4,10}.
Duplicate channels are NOT allowed.
DBOC and MTIC must specify the same number of values.
Output channels may be of any type (8, 16 or 32 bit).

MTIW

Specifies a rectangular window of image to be read from tape.

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

The offset + size must not exceed the image size.

DBOW

Specifies a rectangular window to be written on database.

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

The offset + size must not exceed the image size.

MTID

Specifies string of up to 20 characters which identifies image after it has been read from tape. This is commonly set to the date on which image was taken by satellite or aircraft. MTID is stored in the channel descriptors of database output channels.

 EASI>MTID="dd-mmm-yy"

STARTFIL

Specifies the start file number on tape from which to start reading header and image data. If STARTFIL is greater than one, the program rewinds the tape and advances to the specified file. STARTFIL must be set to the file number required by MSH program to print tape header report.

 EASI>STARTFIL=1              | read first file on tape
 EASI>STARTFIL=n              | read nth file on tape

DETAILS

MIH transfers image data from any set of bands on a PCI tape (MTIC) to any set of image channels on an existing PCIDSK data- base file (DBOC). Normally, an empty database file is created using CIM before running MIH.

Any arbitrary rectangular window on tape (MTIW) can be transferred to any arbitrary rectangular window on the database (DBOW). If no window is specified, then the window is defaulted to the full size window of the display device. Shrinking and/or zooming is automatically performed.

The number of pixels per line (MTIW(3)) to transfer must be less than or equal to 8192 pixels for PC systems, or 32256 pixels for all other systems. The maximum number of pixels per line (MTIW(3)) times the number of bands being read from tape (F$LEN(MTIC)) must be less than or equal to 32768 bytes for PC systems, or 524288 bytes for all other systems. If MIH fails with "work buffer too small" error, this could be remedied by specifying fewer channels and running MIH more than once.

Any file (image) on tape (STARTFIL) can be specified. MIH will rewind, then advance to the selected start file number before transferring.

A 20-character mag tape ID (MTID) can be saved in the channel descriptors for future reference.

 A TAPE MUST BE MOUNTED ON THE TAPE DRIVE BEFORE MIH CAN BE RUN.
 CLEANING THE TAPE HEADS IS RECOMMENDED TO MINIMIZE THE CHANCE OF
 OF TAPE READ ERRORS.

More information on the PCI mag tape format can be found in the documentation for program IMH.

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

Read image from PCI-format tape (written by IMH program). Create database file and transfer upper left 512 by 512 corner of first three channels on tape to database file.

 EASI>FILE="pciimage.pix"
 EASI>DBNC=3
 EASI>DBSZ=512,512
 EASI>RUN CIM
 EASI>MTIC=1,2,3
 EASI>DBOC=1,2,3
 EASI>MTIW=0,0,512,512
 EASI>DBOW=0,0,512,512
 EASI>MTID="test"
 EASI>STARTFIL=1
 EASI>RUN MIH

About PCI Help Gateway