MIW -- WIPS Tape to Database Transfer

Transfers image data from a AVHRR-WIPS magnetic tape to an image database file.

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

PARAMETERS

MIW 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                   4-4       Int
DBOW     Database Output Window                  0-4       Int
MTID     Mag Tape Identification                 0-10      Char
ROTA     Rotate Image: ON/OFF                    2-3       Char
STARTFIL Start File on Tape                      1         Int

FILE

FILE is the filename of the PCIDSK image database to receive output imagery from MIW. The image database must exist prior to running MIW and would be created using CIM. The syntax of the filename is system dependent. 

 EASI>FILE="...filename..."

MTIC

MTIC represents a list of image channels that exist on the input magnetic tape: 

 EASI>MTIC=i,j,...,p            | integers, 1-5

DBOC

DBOC represents a list of image channels that reside in the output image database file: 

 EASI>DBOC=i,j,...,p            | integers, 1-5

MTIW

MTIW specifies a rectangular subset of an image on magnetic tape to be used for input to the MIW task: 

 EASI>MTIW=Xoffset,Yoffset,Xsize,Ysize

DBOW

DBOW specifies a rectangular subset of the image channels in the output image database file that receives imagery from MIW: 

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

MTID

MTID is a string of up to ten characters to identify image data after it is read from a magnetic tape. A common tape ID format consists of an ID string and the date: 

 EASI>MTID="strDDMMMYY"

ROTA

If ROTA="ON", then the image will be rotated 180 degrees. 

 EASI>ROTA="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 file on tape
 EASI>STARTFIL=n              | read nth file on tape

DETAILS

MIW transfers image data from any set of bands on an AVHRR-WIPS 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 MIW.

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 image can be rotated (ROTA) a full 180 degrees before being saved on the database, if desired. This turns the image upside- down. By default, rotation is OFF.

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

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

Read upper-left 512 by 512 corner of first three bands on tape and transfer to first three image channels on database file. 

 EASI>FILE="wipsfile.pix"
 EASI>MTIC=1,2,3
 EASI>DBOC=1,2,3
 EASI>MTIW=0,0,512,512
 EASI>DBOW=0,0,512,512
 EASI>MTID="Tape ID"
 EASI>ROTA="OFF"
 EASI>STARTFIL=1
 EASI>RUN MIW

FORMAT

                TIROS-N/AVHRR TAPE FORMAT

 RECORD 1: TAPEHEADER (2048 BYTES)

 Bytes  1 through 3: equal 0
 Byte   4          : four most  significant bits are spacecraft type
                    0 = NOAA
                    1 = TIROS-N
                    2 = GMS
                    3 = METEOSAT
 Byte   4          : four least significant bits are spacecraft number
 Bytes  5 through 10: year, months, day, hour, min., sec.
 Bytes 11 through  2048: equal 0


 RECORD 2 TO END-OF-FILE: IMAGERY DATA (2048 BYTES/RECORD)
Each Imagery record is formatted as follows: 

        +----+----+----+----+----+-----------+
        | E5 | E4 | E3 | E2 | E1 |  BAND #   |  Byte 1
        +----+----+----+----+----+-----------+
        |       Line number m.s. byte        |  Byte 2
        +------------------------------------+
        |       Line number l.s. byte        |  Byte 3
        +------------------------------------+
        |                                    |
        |       2036 bytes Image data        |  Bytes 4 - 2039
        |                                    |
        +------------------------------------+
        |                                    |  
        |       9 Bytes calibration data     |  Bytes 2040-2048
        |         (subcommutated)            |
        +------------------------------------+
Notes: 

 E1-E5- TIROS-N/AVHRR band enables: 0 = recording disabled
                                    1 = recording enabled

 BAND#-Band number;   0   = Header  
                      1-5 = TIROS-N/AVHRR

 Line number - sequential scan line number, first line off a pass
               line 1 ( header is always 0 ).
               line number is encoded BCD
About PCI Help Gateway