MIS -- SEASAT JSC Tape to Database Transfer


<HEAD><TITLE>MIS -- SEASAT JSC Tape to Database Transfer</TITLE></HEAD>


<H1>MIS -- SEASAT JSC Tape to Database Transfer</H1>
Transfers 16-bit SAR image data from a CCRS SEASAT magnetic tape to
a PCIDSK image database file.<p>
Progress of this program can be monitored. See MONITOR section.
<P>
<H3>PARAMETERS</H3>
MIS is controlled by the following global parameters:
<P>
<pre>Name     Prompt                                  Count     Type
FILE     Database File Name                      1-64      Char
DBOC     Database Output Channel List            1-1       Int
MTIW     Mag Tape Input Window                   0-4       Int
DBOW     Database Output Window                  0-4       Int
MTID     Mag Tape ID                             0-10      Char
MTCH     Magtape Characteristics                 0-7       Int
</pre>
<H4>FILE</H4>
Specify the filename of the PCIDSK database image file to write the
SEASAT mag tape imagery to.
<P>
<PRE>
 EASI&gt;FILE=&quot;filename&quot;
</PRE>
<H4>DBOC</H4>
Specify one output image channels for SEASAT (SAR) data.
<P>
<PRE>
 EASI&gt;DBOC=i               | for 16-bit output data
</PRE>
<UL>
<LI> DBOC can be any type, but unsigned 16-bit integer type is
recommended. 
<LI> If DBOC is 8-bit type, 16-bit values are divided by 256. 
<LI> If DBOC is signed 16-bit, 16-bit values are divided by 2. 
</UL>
<H4>MTIW</H4>
Specify input image window to read from magnetic tape.
<P>
<PRE>
 EASI&gt;MTIW=Xoffset,Yoffset,Xsize,Ysize
 EASI&gt;MTIW=                     | defaults to entire image
</PRE>
<UL>
<LI> Integers, offset + size must not exceed the image size. 
</UL>
<H4>DBOW</H4>
Specify output image window to write to image database.
<P>
<PRE>
 EASI&gt;DBOW=Xoffset,Yoffset,Xsize,Ysize
 EASI&gt;DBOW=                     | defaults to entire image
</PRE>
<UL>
<LI> Integers, offset + size must not exceed the image size. 
</UL>
<H4>MTID</H4>
Specify a string of up to ten characters to identify image data.
MTID is intended as a quick reference for the image data source, and
is stored in the channel descriptors of the output database
channels.
<P>
<PRE>
 EASI&gt;MTID=&quot;..string..&quot;
</PRE>
<H4>MTCH</H4>
Specify user specified mag tape characteristics parameter. It
contains up to seven entries:
<P>
<PRE>
        MTCH(1) = number of pixels per line 
        MTCH(2) = number of lines per image
        MTCH(3) = number of channels
        MTCH(4) = record size in bytes
        MTCH(5) = number of ancillary bytes 
        MTCH(6) = number of files to skip to image data 
        MTCH(7) = number of bits per pixel value
</PRE>
If any of the entries are specified, then these values override the
header values that are read from the tape header.
<P>
<H3>DETAILS</H3>
MIS transfers 16-bit synthetic aperture radar (SAR) image data from
CCRS SEASAT tape to one image channel (DBOC) on an existing PCIDSK
image database file (FILE). Normally, an empty database file is
created using CIM before running MIS.<p>
Any arbitrary rectangular window on tape (MTIW) can be transferred
to any arbitrary rectangular window on the database (DBOW).
Shrinking and/or zooming is automatically performed. By default, the
whole tape image is transferred, filling the entire database.<p>
SEASAT imagery has 16 bits per pixel. Therefore, the output channel
should be either 16-bit unsigned integer or 32-bit real.<p>
If output channel is 8-bit integer, then 16-bit grey-level values
(from 0 to 65535) are divided by 256, to scale data to fit into
8-bit channel (dropping eight least significant bits). If output
channel is 16-bit signed integer, then unsigned 16-bit grey-level
values are divided by 2, to scale data to fit into 15 unsigned bits
(dropping least significant bit). A warning message is printed when
data are scaled.<p>
Tape source headers are sometimes filled with erroneous data. In
order to avoid problems associated with this situation, the user can
employ the values stored in the parameter MTCH to override source
header values. However, the values in MTCH must be greater than
zero, if the user wants to override the header value. Otherwise, the
header value is used. To ensure that header values are used, MTCH
must be defaulted (MTCH=).<p>
The following values of MTCH can be used to override header values:
<P>
<PRE>
        MTCH(1)  : number of pixels per line
        MTCH(2)  : number of lines on tape
        MTCH(3)  : number of channels on tape
        MTCH(4)  : record length in bytes
        MTCH(5)  : number of ancillary bytes 
        MTCH(6)  : number of files to skip to image data 
        MTCH(7)  : number of bits per pixel value
</PRE>
For example, if MTCH(1) = 1, MTCH(2) = 0 and MTCH(3) = 0, and the
corresponding header values are 0, 1, and 0 respectively:<p>
(i) MTCH(1) overrides the header, since its value is greater than
zero.<p>
(ii) Header value is used, since MTCH(2) is NOT greater than zero
AND header value is legal (greater than zero).<p>
(iii) Error message is given, since both values of MTCH(3) AND
header are equal to zero.<p>
A 10-character mag tape ID (MTID) can be saved in the channel
descriptor for future reference.
<P>
<H3>MONITOR</H3>
Program progress can be monitored by printing the percentage of
completed processing in odometer fashion. A system parameter,
MONITOR, controls this activity:
<P>
<PRE>
 EASI&gt;MONITOR=&quot;ON&quot;           | turn monitor ON  (default)
 EASI&gt;MONITOR=&quot;OFF&quot;          | turn monitor OFF (recommended if
                             | running in batch/background mode)
</PRE>
<H3>EXAMPLE</H3>
Read 16-bit SAR data into 16-bit unsigned output channel:
<P>
<PRE>
 EASI&gt;FILE=&quot;SEASAT.PIX&quot;
 EASI&gt;DBOC=1
 EASI&gt;MTIW=
 EASI&gt;DBOW=
 EASI&gt;MTID=&quot;test data&quot;
 EASI&gt;MTCH=
 EASI&gt;RUN MIS
</PRE>
<hr>
<a href="http://www.pcigeomatics.com/dev_corner/pcihlp_gateway.html">About PCI Help Gateway</a>