MBUREP -- DIPIX Format Tape File Report

Prints header data stored on all files on a Dipix BU format tape.

PARAMETERS

MBUREP is controlled by the following global parameters: 

Name     Prompt                                  Count     Type
REPORT   Report mode: TERM/OFF/filename          1-64      Char

REPORT

Specifies the file to which to append the generated report. 

 EASI>REPORT="filename"
Note: The following names have special meaning 

 EASI>REPORT="TERM"     | generates reports on your terminal
 EASI>REPORT="DISK"     | generates reports on file "IMPRPT.LST"
 EASI>REPORT="OFF"      | usually cancels report generation, but
                        | MBUREP forces REPORT to terminal output

DETAILS

MBUREP reports all file headers on a Dipix BU format tape to the report device. Text descriptors are listed for each file (image and non-image). For feature and theme imagery files, the number of bytes per pixel, the number of pixels per line and the number of lines in the image are also listed.

A report device (REPORT parameter) must be selected. If the report device is OFF, MBUREP will force its output to the user's terminal. 

 A TAPE MUST BE MOUNTED ON THE TAPE DRIVE BEFORE MBUREP CAN BE
 RUN.  CLEANING THE TAPE HEADS IS RECOMMENDED TO MINIMIZE THE
 CHANCE OF TAPE READ ERRORS.

TAPE FORMAT

The general format of a Dipix BU tape is shown below. 

                      +--------------+
                      |BU Tape Header|
                      +--------------+
                      |     EOF      |
                      +--------------+
                      |     Data     |
                      |     File     |
                      +--------------+
                      |     EOF      |
                      +--------------+
                      |     Data     |
                      |     File     |
                      +--------------+
                      |     EOF      |
                      +--------------+
                      |      .       | 
                      +--------------+
                      |     Data     |
                      |     File     |
                      +--------------+
                      |     EOF      |
                      +--------------+
                      |     EOF      |
                      +--------------+
The BU tape format does not span tapes. Thus, in a multi-tape set, each tape may be considered complete and MBUREP can operate on it independently.

HEADER

The BU tape header file allows the creator of the tape to store identifying information in free-form ASCII.

The header file consists of one physical record, 512 bytes in length. The contents are completely user definable. This header may be safely skipped by software, unless it is to be displayed for user purposes (tape identification).

DATA FILE

A Dipix data file may be one of three types:

1. A feature file consists of a rectangular area of 8-bit pixel data from sources such as the Landsat MSS or Thematic Mapper. These files are normally stored as an unstructured set of contiguous blocks on disc. It has been the responsibility of the software (user written and Dipix supplied) to enforce an image structure via information stored in the file.

2. A theme file is identical to a feature file structurally. The difference arises from the type of data stored. Theme files contain bitmaps, where each bit within a byte corresponds to a pixel in the bitmap.

3. A Files-11 file is one created using the DEC supplied file system. Typically, these are auxiliary files storing data such as signature, GCPs and training areas. They usually contain only ASCII character data.

These three file tapes have the following structure in common: 

                +--------------+
                |  File Header |
                |  Record      |
                +--------------+
                |              |
                | Data Block   |
                +--------------+
                |      .       |
                |      .       |
                |      .       |
                +--------------+
                |              |
                | Data Block   |
                +--------------+
                |              |
                | Data Block   |
                +--------------+
                |     EOF      |
                +--------------+

EXAMPLE

Print a Dipix BU tape report to the terminal: 

EASI>REPORT="TERM       
EASI>RUN MBUREP

 +--------------------BU Tape Directory---------------------+
 Tape ID: 001        Created: 23-SEP-88 10:32:25
 Description:
 TRAINING AREAS AND SIGNATURE FILES                          
 MEIS UNPACKED TAYLOR PCA FILES FOR ATB                      
                                                             
                                                             

 +===========================================================+
 Non-image file: ATBMSSOFT
 Description:    Lakes
 +-----------------------------------------------------------+
 Non-image file: ATBMSMIXD
 Description:    Meis
 +-----------------------------------------------------------+
 Non-image file: ATBTAMIXD
 Description:    Hardwood
 +-----------------------------------------------------------+
 Non-image file: ATBTASOFT
 Description:    Swamps area
 +-----------------------------------------------------------+
 Image file:     ATBFFUNPR
 Rstream BU Format
 Bytes Per Pixel:     1     Pixels:  1024     Lines:  4301      
 Description:    Island   
 +-----------------------------------------------------------+
 Image file:     ATBFFUNPG
 Rstream BU Format
 Bytes Per Pixel:     1     Pixels:  1024     Lines:  4301      
 Description:    Wheat                                      
 +-----------------------------------------------------------+
About PCI Help Gateway