IMC -- Database to LANDSAT Tape Transfer

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

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

PARAMETERS

IMC 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
STAP     Standard Tape Format: ON/OFF            2-3       Char
MTID     Mag Tape Identification                 0-20      Char
ANCI     Ancillary Bytes: ON/OFF                 2-3       Char

FILE

Specify the PCIDSK file containing imagery data to write to tape: 

 EASI>FILE="file specification"  | input file name

DBIC

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

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

MTOC

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

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

DBIW

The PACE parameter DBIW represents a window on the image database that will be transferred to magnetic tape: 

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

STAP

Specifies whether the tape should be written in standard CCRS format (3600 by 2286) or the input window size: 

 EASI>STAP="OFF"                |input window size 
 EASI>STAP="ON"                 |standard size

MTID

MTID is a 20-character physical volume identifier, used to uniquely reference a particular CCT (mag tape). Usually a tape ID is made up of an ID string and the date. 

 EASI>MTID="XXXDDMMMYY"

ANCI

The user has the option of reserving space for ancillary data: 

 EASI>ANCI="ON"
If STAP="ON", then ANCI is always "ON".

DETAILS

IMC transfers image data from any set of PCI image database channels (DBIC) to any set of CCRS LANDSAT bands on tape (MTOC). The user must specify if the tape is to be written in standard CCRS format (STAP="ON"), or not (STAP="OFF"). A 20-character tape ID (MTID) can be saved on tape for future reference.

Any rectangular input window (DBIW) can be specified for the transfer. However, all transfers to tape are done at full resolution (no shrinking or zooming). The output window offset is (0,0) and output window size equals the input window size.

IMC transfers the JSC (Universal) header and CCRS LANDSAT headers to tape. An identity lookup table is always saved on the LANDSAT tape header.

IMC can transfer only ONE image to each tape. 

 A TAPE MUST BE MOUNTED ON THE TAPE DRIVE BEFORE IMC CAN BE RUN.

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)

STANDARD CCRS FORMAT

An image transferred with standard CCRS format requires a full 2500 foot, 9 track CCT (Computer Compatible Tape). The standard format has 3600 pixels per line, 2286 lines per band, and 4 bands. There are always 178 ancillary bytes per line (the ANCI parameter is ignored in this case). If the image database is smaller than the standard tape size, the image is embedded in the upper left corner and the remaining pixels and lines are set to null. User has to specify 4 channels. If less channel transfer is required, nonstandard format should be used.

The following tape layout would be for a tape created with dimensions 3600 pixels by 2286 lines by 4 bands. 

 Record  Length          Record Description
 number  (bytes)

                UNIVERSAL HEADER

 1       3060          Universal Header

 *** End of file ***
                
                LANDSAT HEADER (Note 1)

  1       1440          LANDSAT Header
  2       2700          Geometric Transformation
  3       1620          Radiometric Transformation (band-1)
  :       :                  : 
  6       1620          Radiometric Transformation (band-4)

 *** End of file ***

                VIDEO DATA  FILE

 3780   1-2:band, 3-180:ancillary, 181-3780:imagery band 1
 3780   1-2:band, 3-3602:imagery band 2, 3603-3780:ancillary
 3780   1-2:band, 3-3602:imagery band 3, 3603-3780:ancillary
 3780   1-2:band, 3-3602:imagery band 4, 3603-3780:ancillary

 *** End of file ***
 *** End of file ***
This file is supplied for structural purposes only and contains no useful information.

NONSTANDARD FORMAT

The nonstandard format can have any number of pixels, lines, and channels (whatever the user specifies). However, nonstandard images cannot be larger than the standard 3600 pixel per line images. The tape size matches the input window size exactly (no embedding is needed). The number of channels (bands) on tape equals the number of elements specified in MTOC. There can be no "null" output bands.

If ANCI="ON", null ancillary data (178 bytes) are written on each line. If ANCI="OFF", no ancillary data are written. (OFF is the default setting for ANCI).

The following tape layout would be for a tape created with dimensions P pixels by L lines by B bands. 

 Record  Length          Record Description
 number  (bytes)

                UNIVERSAL HEADER


  1       3060          Universal Header

 *** End of file ***
                
                LANDSAT HEADER (Note 1)

   1       1440          LANDSAT Header
   2       2700         Geometric Transformation
   3       1620         Radiometric Transformation (band-1)
   :        :                  : 
   N       1620         Radiometric Transformation (band-n)

 *** End of file ***

                VIDEO DATA  FILE (n-bands)
If ANCI="ON" the ancillary data is set to null 

 3780   1-2:band, 3-180:ancillary, 181-3780:imagery band 1
 3780   1-2:band, 3-3602:imagery band 2, 3603-3780:ancillary
 3780   1-2:band, 3-3602:imagery band 3, 3603-3780:ancillary
  :       :   :         :                    :
 3780   1-2:band, 3-3602:imagery band N, 3603-3780:ancillary
If ANCI="OFF" the ancillary data is not written 

 3780   1-2:band, 3-3780:imagery band 1
 3780   1-2:band, 3-3780:imagery band 2
 3780   1-2:band, 3-3780:imagery band 3
  :       :   :         :               
 3780   1-2:band, 3-3780:imagery band N

 *** End of file ***
 *** End of file ***
This file is supplied for structural purposes only and contains no useful information.

EXAMPLE

Object: Transfer agriculture survey to mag tape. mount tape... 

 EASI>FILE="AGRIHOT.PIX"
 EASI>DBIC=1,2,3,4,5,6,7,8,9,10,11
 EASI>MTOC=DBIC
 EASI>DBIW=0,0,1024,1024
 EASI>STAP="OFF"
 EASI>MTID="AGRIHOT 1"
 EASI>ANCI="OFF"
 EASI>RUN IMC
About PCI Help Gateway