MIZ -- NOPS CZCS Tape to Database Transfer

Transfers image data from a NOPS NIMBUS-7 (CZCS) magnetic tape to a PCIDSK image database file.

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

PARAMETERS

MIZ 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-6       Int
DBOC     Database Output Channel List            1-6       Int
MTIW     Mag Tape Input Window                   0-4       Int
DBOW     Database Output Window                  0-4       Int
MTID     Mag Tape Identification                 0-10      Char
FLIP     Flip Image: ON/OFF                      2-3       Char
STARTFIL Start File on Tape                      1         Int

FILE

Specify the PCIDSK file to write imagery data to : 

 EASI>FILE="file specification" | input file name

MTIC

The PACE parameter MTIC represents a list of image channels that reside on the input magnetic tape: 

 EASI>MTIC=i,j,...,m             | integers, 1-6

DBOC

The PACE parameter DBOC represents a list of output image channels that reside on the image database file: 

 EASI>DBOC=i,j,...,m             | integers, 1-6

MTIW

The PACE parameter MTIW represents a window on the mag tape that will be transferred to the image database: 

 EASI>MTIW=Xoffset,Yoffset,Xsize,Ysize

DBOW

The PACE parameter DBOW represents a window on the image database where data will be transferred from magnetic tape: 

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

MTID

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

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

 EASI>MTID="XXXDDMMMYY"

FLIP

Set FLIP="ON" for image flip. 

 EASI>FLIP="OFF"

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 image on tape
 EASI>STARTFIL=n*2 - 1        | read nth image on tape
Each image requires 2 files: a header file and an data file. Therefore, to read image 1, 2, 3 or 4, set STARTFIL to 1, 3, 5 or 7 respectively. To read nth image on tape, set STARTFIL to n*2 - 1.

DETAILS

MIZ transfers image data from any set of bands on an NOPS NIMBUS-7 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 MIZ.

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. performed. To specify MTIW parameter run MAGSTRU first to get number of lines for the required file. Number of pixel on tape is fixed and equal 1968. Number of band on the tape is always 6. If MTIW is defaulted program assumed the number of lines as 970 (MTIW=0,0,1968,970).

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

The image can be flipped (FLIP) before being saved on the database, if desired. This turns the image upside-down. By default, flipping is OFF. 

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

The number of lines of image data on CZCS NOPS tape is unknown. Run MAGSTRU program to determine the number of lines (records) on each file on tape. The number of pixels per line is fixed at 1968, and the length of image records is fixed at 12780 bytes. 

 EASI>REPORT=                           | report to terminal
 EASI>R MAGSTRU
Example Report: 

        2 rec 630       (header file for 1st image on tape)
          EOF
        1 rec  5328     
      769 rec  12780    (769 lines of data for 1st image)
        1 rec  5328
          EOF
        2 rec 630       (header file for 2nd image on tape)
          EOF
        1 rec  5328
      970 rec  12780    (970 lines of data for 2nd image)
        1 rec  5328
          EOF
        "   "
        2 rec 630       (header file for last image on tape)
          EOF
        1 rec  5328
      481 rec  12780    (481 lines of data for last image)
        1 rec  5328
          EOF   
          EOF           (end of tape, last file)
To read the first image on tape (STARTFIL=1), specify MTIW = 0,0,1968,769. 

 EASI>FILE="example.pix"
 EASI>MTIC=1,2,3,4,5,6
 EASI>DBOC=1,2,3,4,5,6
 EASI>MTIW=0,0,1968,769
 EASI>DBOW=                     
 EASI>MTID=
 EASI>FLIP="OFF"
 EASI>STARTFIL=1
 EASI>RUN MIZ
About PCI Help Gateway