IMH -- Database to PCI Tape Transfer

Transfers image data from an image database file to a magnetic tape with PCIDSK format.

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

PARAMETERS

IMH is controlled by the following global parameters: 

Name     Prompt                                  Count     Type
FILE     Database File Name                      1-64      Char
DBIC     Database Input Channel List             1-16      Int
MTOC     Mag Tape Output Channel List            1-16      Int
DBIW     Database Input Window                   0-4       Int
MTSZ     Mag Tape Image Size (Pixels, Lines)     0-2       Int
TEX1     Database Descriptive Text 1             0-64      Char

FILE

FILE is the filename of the PCIDSK image database used for input to IMH. The syntax of the filename is system dependent. 

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

DBIC

DBIC is the list of image channels to read from the input database image file: 

 EASI>DBIC=i,j,...,p            | integers, 1-16

MTOC

MTOC is the list of output image channels to be written to magnetic tape: 

 EASI>MTOC=i,j,...,p            | integers, 1-16

DBIW

DBIW specifies a rectangular subset of the image database to be used as input to the task: 

 EASI>DBIW=Xoffset,Yoffset,Xsize,Ysize
 EASI>DBIW=                     | defaults to entire image
The offset + size must not exceed the image size.

MTSZ

MTSZ specifies the output image channel size on magnetic tape: 

 EASI>MTSZ=i,j                  | integers
The first element represents the number of pixels per line and the second element is the number of lines. If defaulted, MTSZ will take the number of pixels, number of lines specified in DBIW(3), DBIW(4) respectively.

TEX1

Optionally specifies a 64-character tape descriptor. 

 EASI>TEX1="string"

DETAILS

IMH transfers image data from PCIDSK image database channels (DBIC) to PCI format tape bands (MTOC). There may be up to 16 image bands transferred to tape.

The mag tape size (MTSZ) specifies the number of pixels per line and the number of lines per band to be written on tape. If defaulted, MTSZ will be set as the input database window dimensions defined by DBIW(3) and DBIW(4). If DBIW is defaulted, the entire image database will be written to tape.

Appropriate headers are written on tape before image data are written. The database pixel size is saved on the tape header.

IMH can write several frames (images) on the same tape. This is done by running IMH once for each image, using the same tape, without rewinding the tape between runs. 

 A TAPE MUST BE MOUNTED ON THE TAPE DRIVE BEFORE RUNNING IMH.

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)

FORMAT

                 P C I   T A P E   F O R M A T
 +----------------------------------------------------------+
 |   Record 1: Header                                      |
 |   ----------------                                      |
 |    Note:  integer I*2 values are stored with the most   |
 |          significant byte first.                        |
 |                                                         |
 |    Bytes   Type   Contents                              |
 |                                                         |
 |     1- 2    I*2   Number of Lines            (L)        |
 |     3- 4    I*2   Number of Pixels/Line      (P)        |
 |     5- 6    I*2   Number of Channels         (C)        |
 |     7- 8    I*2   X Pixel Size       (metres)           |
 |     9-10    I*2   Y Pixel Size       (metres)           |
 |    11-12    C*2   Creation Day                          |
 |    13-16    C*4   Creation Month                        |
 |    17-18    C*2   Creation Year                         |
 |    19-20    I*2   Data Record Length (N Bytes/record)   |
 |    21-84    C*64  Descriptor                            |
 |    85-512   C*428 Reserved                              |
 |                                                         |
 |   Record 2 to L+1 : Image data                          |
 |   -----------------------------                         |
 |   A record contains 1 channel for 1 line. Where         |
 |   a record size is is given in bytes 19-20 of header    |
 |                                                         |    
 |   L - Lines                                             |
 |   C - Channels                                          |
 |   P - Pixels per line                                   |
 |                                                         |
 |              +-------------------------------+          |
 |   Rec 2      |      Line 1     Channel 1     |          |
 |              +-------------------------------+          |
 |       3      |      Line 1     Channel 2     |          |
 |              +-------------------------------+          |
 |              |               :               |          |
 |              +-------------------------------+          |
 |       C+1    |      Line 1     Channel C     |          |
 |              +-------------------------------+          |
 |              |               :               |          |
 |              +-------------------------------+          |
 |  (L-1)*C+L+1 |      Line L     Channel 1     |          |
 |              +-------------------------------+          |
 |              |               :               |          |
 |              +-------------------------------+          |
 |      C*L+1   |      Line L     Channel C     |          |
 |              +-------------------------------+          |
 |   **End-of-file**                                       |
 +----------------------------------------------------------+

EXAMPLE

Write first three channels on irvine.pix to tape, using PCI format. 

 EASI>FILE="irvine.pix"
 EASI>DBIC=1,2,3
 EASI>MTOC=1,2,3
 EASI>DBIW=
 EASI>MTSZ=
 EASI>TEX1="EASI/PACE Training Data Set Image"
 EASI>R IMH
About PCI Help Gateway