MVZ -- NOPS CZCS Tape to Video Transfer


<HEAD><TITLE>MVZ -- NOPS CZCS Tape to Video Transfer</TITLE></HEAD>


<H1>MVZ -- NOPS CZCS Tape to Video Transfer</H1>
Transfers image data from a NOPS NIMBUS-7 (CZCS) magnetic tape to
the video display.
<P>
<H3>PARAMETERS</H3>
MVZ is controlled by the following global parameters:
<P>
<pre>Name     Prompt                                  Count     Type
MTIC     Mag Tape Input Channel List             1-6       Int
VDOC     Video Output Channel List               1-6       Int
MTIW     Mag Tape Input Window                   0-4       Int
VDOW     Video Output Window                     0-4       Int
FLIP     Flip Image: ON/OFF                      2-3       Char
STARTFIL Start File on Tape                      1         Int
</pre>
<H4>MTIC</H4>
The PACE parameter MTIC represents a list of image channels that
reside on the input magnetic tape:
<P>
<PRE>
 EASI&gt;MTIC=i,j,...,n             | integers, 1-6
</PRE>
<UL>
<LI> Only the channels specified in MTIC are used by MVZ. 
<LI> Up to 6 channels can be handled. 
<LI> Ranges of channels can be specified with negative values. For
example: {1,-4,6} is internally expanded to {1,2,3,4,6}. 
</UL>
<H4>VDOC</H4>
The PACE parameter VDOC represents the video output channels where
the data will be transferred from mag tape:
<P>
<PRE>
 EASI&gt;VDOC=i,j,...,m             | integers, 1-6
</PRE>
<UL>
<LI> Up to 6 channels can be handled. 
<LI> Ranges of channels can be specified with negative values. For
example: {1,-4,6} is internally expanded to {1,2,3,4,6}. 
</UL>
<H4>MTIW</H4>
The PACE parameter MTIW represents a window on magnetic tape that
will be transferred to the video display:
<P>
<PRE>
 EASI&gt;MTIW=Xoffset,Yoffset,Xsize,Ysize
</PRE>
<H4>VDOW</H4>
The PACE parameter VDOW represents a window on the video display
where the data will be transferred from magnetic tape.
<P>
<PRE>
 EASI&gt;VDOW=Xoffset,Yoffset,Xsize,Ysize
 EASI&gt;VDOW=                     | defaults to entire display
</PRE>
<H4>FLIP</H4>
If FLIP=&quot;ON&quot;, image is flipped.
<P>
<PRE>
 EASI&gt;FLIP=&quot;OFF&quot;
</PRE>
<H4>STARTFIL</H4>
Specifies the start file number on tape from which to start reading
header and image data. If STARTFIL is greater than one, the program
rewinds the tape and advances to the specified file. STARTFIL must
be set to the file number required by MSH program to print tape
header report.
<P>
<PRE>
 EASI&gt;STARTFIL=1              | read first image on tape
 EASI&gt;STARTFIL=n*2 - 1        | read nth image on tape
</PRE>
Each image requires 2 files: a header file and an data file.
Therefore, to read image 1, 2, 3 or 4, set STARTFIL to 1, 3, 5 or 7
respectively. To read nth image on tape, set STARTFIL to n*2 - 1.
<P>
<H3>DETAILS</H3>
MVZ transfers image data from any set of bands on NOPS NIMBUS-7 tape
(MTIC) to any set of image planes on a video display (VDOC).<p>
Any arbitrary rectangular window on tape (MTIW) can be transferred
to any arbitrary rectangular window on the display (VDOW). Shrinking
and/or zooming is automatically performed. To specify MTIW parameter
run MAGSTRU first to get number of lines for the required file.
Number of pixel on tape is fixed and equal 1968. Number of band on
the tape is always 6. If MTIW is defaulted program assumed the
number of lines as 970 (MTIW=0,0,1968,970).<p>
The image can be flipped (FLIP) while transferring to the display,
turning the image upside-down. By default, flipping is OFF.
<P>
<PRE>
 A TAPE MUST BE MOUNTED ON THE TAPE DRIVE BEFORE MVZ CAN BE RUN.
 CLEANING THE TAPE HEADS IS RECOMMENDED TO MINIMIZE THE CHANCE
 OF TAPE READ ERRORS.
</PRE>
<H3>EXAMPLE</H3>
The number of lines of image data on CZCS NOPS tape is unknown. Run
MAGSTRU program to determine the number of lines (records) on each
file on tape. The number of pixels per line is fixed at 1968, and
the length of image records is fixed at 12780 bytes.
<P>
<PRE>
 EASI&gt;REPORT=                           | report to terminal
 EASI&gt;R MAGSTRU
</PRE>
Example Report:
<P>
<PRE>
        2 rec 630       (header file for 1st image on tape)
          EOF
        1 rec  5328     
      769 rec  12780    (769 lines of data for 1st image)
        1 rec  5328
          EOF
        2 rec 630       (header file for 2nd image on tape)
          EOF
        1 rec  5328
      970 rec  12780    (970 lines of data for 2nd image)
        1 rec  5328
          EOF
        &quot;   &quot;
        2 rec 630       (header file for last image on tape)
          EOF
        1 rec  5328
      481 rec  12780    (481 lines of data for last image)
        1 rec  5328
          EOF   
          EOF           (end of tape, last file)
</PRE>
To read the first image on tape (STARTFIL=1), specify MTIW =
0,0,1968,769.
<P>
<PRE>
 EASI&gt;MTIC=1,2,3
 EASI&gt;VDOC=1,2,3
 EASI&gt;MTIW=0,0,1968,769
 EASI&gt;VDOW=                     
 EASI&gt;MTID=
 EASI&gt;FLIP=&quot;OFF&quot;
 EASI&gt;STARTFIL=1
 EASI&gt;RUN MVZ
</PRE>
<hr>
<a href="http://www.pcigeomatics.com/dev_corner/pcihlp_gateway.html">About PCI Help Gateway</a>