IMT -- Database to TIROS/NOAA Tape Transfer

Transfers image data from an image database file to a magnetic tape with AES TIROS/NOAA (AVHRR) format.

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

PARAMETERS

IMT is controlled by the following global parameters: 

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

FILE

FILE is the filename of the PCIDSK image database to read imagery from IMT. The syntax of the filename is system dependent. 

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

DBIC

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

 EASI>DBIC=i,j,...m

MTOC

The PACE parameter MTOC represents a list of output image channels that will receive data on a magnetic tape: 

 EASI>MTOC=i,j,...m                 | integers, 1-5

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=                             | use entire image
The offset + size must not exceed the image size.

MTSZ

MTSZ specifies the output image channel size on magnetic tape. The first element represents the number of pixels per line and the second element is the number of lines. 

 EASI>MTSZ=i,j                  | integers
i can be either 1024 or 2048.

DETAILS

IMT transfers image data from PCIDSK image database channels (DBIW) to AES TIROS/NOAA (AVHRR) format tape bands (MTOC). Up to five image bands can be transferred to tape. There are two ways image data can be written on tape: half frame data format, which stores up to 1024 pixels per line, and full frame data format, which stores up to 2048 pixels per line.

The magnetic tape size (MTSZ) specifies the number of pixels per line (either 1024 or 2048) and the number of lines per band (any number) to be written on tape. Five bands are always written on tape, even if less than five input channels are specified. (Unused tape bands are set to null.) The rectangular database input window (DBIW) specified is adjusted to fill the entire tape frame by shrinking or zooming the input data. Appropriate headers are written on tape before the image data is written.

IMT can write several frames (images) on the same tape. This is done by running IMT 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 IMT.

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

mount tape... 

 EASI>FILE="AGRIHOT.PIX"
 EASI>DBIC=1,2,3,4,5
 EASI>MTOC=DBIC
 EASI>DBIW=                             |default 1024,1024
 EASI>MTSZ=1024,1024
 EASI>RUN IMT

FORMAT

 +--------------------------------------------------------------+
 |   Record 1: File header (1024 bytes)                         |
 |   ---------------------                                      |
 |    Note: Integer values (I*2) are stored with the most       |
 |         significant byte first. UNUSED fields are zeroed.    |
 |                                                              |
 |    Bytes    Contents                                         |
 |                                                              |
 |     1- 2    = -1                                             |
 |     3- 4    Satellite ID = 7 for NOAA-7                      |
 |     5-16    UNUSED                                           |
 |    17-18    Day          created by PCI task IMT             |
 |    19-20    Hour            "    "   "   "    "              |
 |    21-22    Minute          "    "   "   "    "              |
 |    23-24    Second * 100    "    "   "   "    "              |
 |    24-26    Year            "    "   "   "    "              |
 |    27-38    UNUSED                                           |
 |    39-40    Number of pixels per scanline                    |
 |            (1024, half frame; 2048, full frame)              |
 |    41-42    UNUSED                                           |
 |    43-44    Number of first pixel in the scanline            |
 |            (513 for half frame; 1 for full frame)            |
 |    45-54    UNUSED                                           |
 |    55-56    Number of scanlines in the image                 |
 |    57-1024  UNUSED                                           |
 |                                                              |
 |   Record 2: Telemetry data (1280 bytes) - UNUSED             |
 |   ------------------------                                   |
 |                                                              |
 |   Record 3: Lookup table (5120 bytes)        - UNUSED        |
 |   ---------------------                                      |
 |                                                              |
 |   Record 4 - N: Image data (10434 bytes)                     |
 |   ------------------------                                   |
 |   A data record consists of:                                 |
 |   1. Telemetry data (TE) -   194 bytes, UNUSED               |
 |   2. Image data (C1-C5)  - 10240 bytes.                      |
 |                                                              |
 |   Half frame format: scanlines I and I+1                     |
 |   +----------------------------------------------------+     |
 |   |TE| C1 | C2 | C3 | C4 | C5 | C1 | C2 | C3 | C4 | C5 |     |
 |   +----------------------------------------------------+     |
 |                                                              |
 |   Full frame format: scanline I                              |
 |   +----------------------------------------------------+     |
 |   |TE|   C1    |   C2    |   C3    |   C4    |   C5    |     |
 |   +----------------------------------------------------+     |
 +--------------------------------------------------------------+
About PCI Help Gateway