MPTQUAD -- LGSOWG CCT-PT Tape to Database Transfer

Transfers and mosaics four quadrants unsigned 8-bit image data from a LGSOWG CCT-PT tape to the image database. This program creates a new image database file, if it does not already exist.

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

See Also: MIL, MSH

PARAMETERS

MPTQUAD 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-7       Int

FILE

Specifies the name of the PCIDSK image database to receive output imagery from MPTQUAD. If the image database does not exist, the program will ask the user whether to create the database automatically or not. The syntax of the filename is system dependent.

 EASI>FILE="...filename..."
If the image database exists, it MUST be exactly 6967 pixels X 5965 lines, and the number of channels on the database must be greater than or equal to the number of input channels on the tape (MTIC).

MTIC

Specifies a list of image channels that exist on the input magnetic tape. The image data is unsigned integer data in 8-bits (values, 0 to 255).

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

DETAILS

MPTQUAD reads and mosaics unsigned 8-bit image data from a BIL (Band Interleaved by Line) or BSQ (Band Sequential) LGSOWG CCT-PT (LANDSAT Ground Station Operators' Working Group) format tape. Unsigned 8-bit integer data have values between 0 and 255;

If the image database does not exist, the MPTQUAD program will ask the user whether to create the database automatically or not. If the image database does exist, it MUST be the size of a 4 quadrant scene: 6967 pixels X 5965 lines. The number of channels on the database must be greater than or equal to the number of input channels on the tape (MTIC).

Image data is transferred from any set of image channels on tape (MTIC) to the image channels on the database in sequential order. Channel number one will receive data from the first band in MTIC and the next band will be transfer sequentially to the database.

                     Window Limit
     QUADS specifications   Pixel  Line   +-------------------------------+  
     +-------------------+  +-----------+ |               |               | 
     1,2,3,4(all 4 quads):   6967 x 5965  |               |               |
     1 quadrant          :   4220 x 2982  |  Quadrant 1   |  Quadrant 2   | 
     2 quadrant          :   4220 x 2982  |               |               |
     3 quadrant          :   4220 x 2983  |               |               | 
     4 quadrant          :   4220 x 2983  |               |               |
                                   |-------------------------------| 
                                   |               |               |
                                   |               |               |
                                   |  Quadrant 3   |  Quadrant 4   |
                                   |               |               |
                                   |               |               |
                                   |               |               |
                                   +-------------------------------+
                                   <------4220----->
                                   <--------------6967------------->


      A full TM scene (7 bands, all 4 quadrants) requires approximately 
      584.864 blocks (285 megabytes).

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)

TAPE SEQUENCE

The TM LGSOWG CCT PT format includes two logical volumes for every quadrant. A logical volume pair consists of three 1600 bpi tapes or a single 6250 bpi tape. The logical volumes are designated as the imagery logical volume and the supplemental logical volume.

For 6250 bpi LGSOWG CCT PT tapes, the sequence of mounting quadrant tapes is not important.

Because of the volume of image data, 1600 bpi LGSOWG CCT PT data sets are spread over three physical tapes for every quadrant.

If the tape set has the image data arranged as BIL (Band Interleaved by Line) then the user MUST initially mount tape 1 in the set so certain header information can be extracted. Further tapes in the set must be mounted in ascending order, but tapes with no useful data can be skipped.

If the tape set is BSQ (Band SeQuential), the user has more flexibility. Tapes must still be mounted in ascending order, but tapes which contain no requested bands can be skipped, and the first tape mounted does not have to be tape 1. For example, suppose we have a 4-tape set containing 7 bands arranged as:

        Tape 1, bands: 1,2
        Tape 2, bands: 3,4
        Tape 3, bands: 5,6
        Tape 4, bands: 7
If the user requested only bands 4 and 7 (i.e., MTIC=4,7), then tape 2 could be mounted first, followed by tape 4.

MPTQUAD is fairly robust and will usually prevent the user from mounting tapes out of order if required information is skipped; however, if any problems occur (such as apparently missing data), it is always safest to mount tapes sequentially starting at 1.

EXAMPLE 1

The user wants to read the image data on a 6250 bpi, four LGSOWG CCT PT tape set, which contains 4 quadrants of Ontario area, to a database file ontario.pix, which will be created by the MPTQUAD program.

The user mounts the tape with the first quadrant and runs the MPTQUAD program.

 EASI>FILE="ontario.pix"
 EASI>MTIC=1,-5
 EASI>RUN MPTQUAD

 Output file does not exist!
 A file with 6967 pixels X 5965 lines X 5 channels 
 Approximate size is 207790775 bytes
 Create a new one? [Y/N]: Y
The program will create the required image database and store the first quadrant on the newly created ontario.pix file.

The user mounts the tape with the second quadrant and runs MPTQUAD again. The database file name is ontario.pix, which was created when the first quadrant was processed.

 EASI>MTIC=1,-5
 EASI>RUN MPTQUAD
The user mounts the tape with the third quadrant and runs MPTQUAD again. The database file name is ontario.pix, which was created when the first quadrant was processed.

 EASI>MTIC=1,-5
 EASI>RUN MPTQUAD
The user mounts the tape with the fourth quadrant and runs MPTQUAD again. The database file name is ontario.pix, which was created when the first quadrant was processed.

 EASI>MTIC=1,-5
 EASI>RUN MPTQUAD

About PCI Help Gateway