MIM -- MDA Tape to Database Transfer
Transfers image data from an MDA resampled magnetic tape to an image
database file.
Progress of this program can be monitored. See MONITOR section.
PARAMETERS
MIM 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-5 Int
DBOC Database Output Channel List 1-5 Int
MTIW Mag Tape Input Window 0-4 Int
DBOW Database Output Window 0-4 Int
MTSZ Mag Tape Size (Pixels,Lines) 2 Int
MTID Mag Tape Identification 0-10 Char
STARTFIL Start File on Tape 1 Int
FILE
The 64-character filename of the output PCIDSK database image file.
The syntax of the file specification is system dependent.
EASI>FILE="filename"
MTIC
MTIC represents the list of image channels to be read from the input
magnetic tape.
EASI>MTIC=i,j,...m | integers, 1-5
- Only the channels specified in MTIC are used by MIM.
- Ranges of channels can be specified with negative values. For
example: {1,-4,10} is internally expanded to {1,2,3,4,10}.
DBOC
DBOC represents the list of image channels to be written to the
output image database file.
EASI>DBOC=i,j,...m | integers, 1-5
- Output channels may be of any type (8, 16 or 32 bit).
- Ranges of channels can be specified with negative values. For
example: {1,-4,10} is internally expanded to {1,2,3,4,10}.
MTIW
MTIW specifies the image dimensions to read from the mag tape image
file.
EASI>MTIW=Xoffset,Yoffset,Xsize,Ysize
EASI>MTIW= | defaults to entire image
- Integers, offset + size must not exceed the image size.
DBOW
DBOW specifies the image dimensions in the output database image for
receiving the mag tape imagery.
EASI>DBOW=Xoffset,Yoffset,Xsize,Ysize
EASI>DBOW= | defaults to entire image
- Integers, offset + size must not exceed the image size.
MTSZ
MTSZ specifies the image channel size on the magnetic tape. The
first element is the number of pixels per scanline. The second
element is the number of scanlines in the image channel.
EASI>MTSZ=i,j
Only two sizes are allowed at present:
MTSZ = 640,600 (large size)
MTSZ = 320,160 (small size)
MTID
MTID is a string of up to ten characters to identify image data
after it is read from a mag tape. MTID is intended as a quick
reference for the image data source and is stored in the channel
descriptors of the database output channels.
EASI>MTID="..string.."
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
MIM transfers image data from any set of bands on an MDA re- sampled
tape (MTIC) to any set of image channels on an existing PCIDSK
database file (DBOC). Normally, an empty database file is created
using CIM before running MIM. MDA resampled tapes have AVHRR format
headers that can be read using MSH.
Any arbitrary rectangular window on tape (MTIW) can be transferred
to any arbitrary rectangular window in the image database (DBOW).
Shrinking and/or zooming is automatically performed. By default, the
whole tape image is transferred, filling the entire database.
The mag tape image size (MTSZ) must be explicitly specified. Only
two sizes are allowed at present:
MTSZ = 640,600 (large size)
MTSZ = 320,160 (small size)
A ten-character mag tape ID (MTID) can be saved in the channel
descriptors for future reference.
Any start file number on tape (STARTFIL) can be specified. MIM will
rewind and then advance to the selected start file number before
transferring.
A TAPE MUST BE MOUNTED ON THE TAPE DRIVE BEFORE MIM CAN BE RUN.
CLEANING THE TAPE HEADS IS RECOMMENDED TO MINIMIZE THE CHANCE OF
TAPE READ ERRORS.
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
EASI>FILE="AGRIHOT.PIX"
EASI>MTIC=1,2,3,4,5
EASI>DBOC=1,2,3,4,5
EASI>MTIW=\DBOW= | both defaulted
EASI>MTSZ=512,512
EASI>MTID="ALBERTA1"
EASI>STARTFIL=2
EASI>RUN MIM
About PCI Help Gateway