MIC -- CCRS JSC Tape to Database Transfer

Transfers image data from any CCRS LANDSAT magnetic tape (including DICS format) to an image database file.

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

PARAMETERS

MIC 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 Identification                 0-10      Char
STARTFIL Start File on Tape                      1         Int
MTCH     Mag Tape Characteristics                0-7       Int

FILE

Specify the PCIDSK file to write imagery data to. 

 EASI>FILE="file specification"

MTIC

Specifies a list of image channels that reside on the input magnetic tape. 

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

DBOC

Specifies a list of output image channels that reside on a database image file. 

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

MTIW

Specifies a window on the magnetic tape to be transferred to the image database file. 

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

DBOW

Specifies a window on the image database, where data will be transferred from magnetic tape. 

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

MTID

MTID is a 10-character physical volume identifier, used to uniquely reference a particular CCT (magnetic tape).

Usually, a tape ID is made up of an ID string and the date. 

 EASI>MTID="XXXDDMMMYY"

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=n              | read nth file on tape
STARTFIL is set to 1,4,7,10,..., for images 1,2,3,4.., on tape. The formula for STARTFIL is 3*n-2, where `n' is the start image number on tape. This is necessary because there are normally three "files" per image on tape: the first two are headers, while the last is the imagery.

MTCH

This is a user-specified magnetic tape characteristics parameter. It contains up to seven entries: 

        MTCH(1) = number of pixels per line 
        MTCH(2) = number of lines per image
        MTCH(3) = number of channels
        MTCH(4) = record size in bytes
        MTCH(5) = number of ancillary bytes 
        MTCH(6) = number of files to skip to image data 
        MTCH(7) = number of bits per pixel value
If any of the entries are specified, then these values will override the values that are read in off the tape header.

DETAILS

MIC transfers image data from any set of bands on CCRS LANDSAT tape (MTIC) to any set of image channels on an existing PCI database file (DBOC). Normally, an empty database file is created using CIM before running MIC.

Any arbitrary rectangular window on tape (MTIW) can be transferred to any arbitrary rectangular window on the database (DBOW). Shrinking and/or zooming is automatically performed. By default, the whole tape image is transferred, filling the entire database.

The number of pixels per line times the number of channels on tape must be less than or equal to 32768 bytes (16384 on PCs). The maximum record length that can be read is 524288 bytes (16384 on PCs).

Tape source headers are sometimes filled with erroneous data. In order to avoid problems associated with this situation, the user can employ the values stored in the parameter MTCH in PRM.PRM to override source header values. However, the values in MTCH must be greater than zero if the user wants to override the header value. Otherwise, the header value is used. If the user wishes to ensure that the header values are used, then the following must be typed: 

 EASI> MTCH=
The following elements of MTCH can be employed to override the header values: 

        MTCH(1)  : number of pixels per line
        MTCH(2)  : number of lines on tape
        MTCH(3)  : number of channels on tape
        MTCH(4)  : record length in bytes
        MTCH(5)  : number of ancillary bytes 
        MTCH(6)  : number of files to skip to image data 
        MTCH(7)  : number of bits per pixel value
For example, if (i) MTCH(1) = 1 (ii) MTCH(2) = 0 (iii) MTCH(3) = 0 and the corresponding header values are (i) 0 (ii) 1 (iii) 0 , then:

(i) MTCH(1) overrides header since its value is greater than zero.

(ii) Header value is used since MTCH(2) is NOT greater than zero, AND header value is legal (greater than zero).

(iii) Error message is given since both values of MTCH(3) AND header are equal to zero.

A 10-character Magnetic Tape ID (MTID) can be saved in the channel descriptor for future reference.

More information on CCRS format can be found in the documentation for program IMC. 

 A TAPE MUST BE MOUNTED ON THE TAPE DRIVE BEFORE MIC 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

Before running MIC, check header information by MSH program: 

 EASI>STARTFIL=1
 EASI>REPORT="TERM"
 EASI>RUN MSH


 EASI>FILE="AGRIHOT.PIX"
 EASI>MTIC=1,2,3
 EASI>DBOC=1,2,3
 EASI>MTIW=\DBOW=                       | both defaulted
 EASI>MTID="ALBERTA1"
 EASI>STARTFIL=1                        | first image
 EASI>MTCH=                             | use header values
 EASI>RUN MIC
About PCI Help Gateway