MBUGCP -- DIPIX Format Tape GCP Transfer


<HEAD><TITLE>MBUGCP -- DIPIX Format Tape GCP Transfer</TITLE></HEAD>


<H1>MBUGCP -- DIPIX Format Tape GCP Transfer</H1>
Reads a ground control points file from an R-stream Dipix BU tape
and creates a new ground control points segment on a PCIDSK database
file.
<P>
<H3>PARAMETERS</H3>
MBUGCP is controlled by the following global parameters:
<P>
<pre>Name     Prompt                                  Count     Type
BUFILE   DIPIX Filename                          1-13      Char
FILE     Database File Name                      1-64      Char
DBSN     Database Segment Name                   1-8       Char
DBSD     Database Segment Description            0-64      Char
</pre>
<H4>BUFILE</H4>
Specifies the name of the BU file to be read. MBUGCP will read only
one BU file per run. The filename should be of the form:
<P>
<PRE>
 Character:         1 2 3  4 5  6 7 8 9  10 11 12 13
 Contents:          (A A A)(G C)(C C C C)(. G C F)
</PRE>
Characters 1 through 3 specify a Dipix area name. Characters 4 and 5
specify the type of file type (GC). Characters 6 through 9 specify a
Dipix GCP file name. Characters 10 through 13 specify the file
extension, which is normally .GCF for ground control point files. If
the file extension is not specified, it defaults to &quot;.GCF&quot;.
<P>
<PRE>
 EASI&gt;BUFILE=&quot;...string...&quot;
</PRE>
<H4>FILE</H4>
Specifies the PCIDSK file to which to write the ground control point
data.
<P>
<PRE>
 EASI&gt; FILE = &quot;file_spec&quot;
</PRE>
<H4>DBSN</H4>
Specifies a 1 to 8-character name that will be assigned to the
database ground control points (type 213:GCP) segment.
<P>
<PRE>
 EASI&gt;DBSN=&quot;project &quot;
</PRE>
<H4>DBSD</H4>
Optionally specifies a 1 to 64-character descriptor that will be
associated with the output ground control points.
<P>
<PRE>
 EASI&gt;DBSD=&quot;string describing contents or origin of data&quot;
</PRE>
<H3>DETAILS</H3>
MBUGCP will read a Ground Control Points file (BUFILE) from a Dipix
BU tape and writes it to a new Ground Control Point (GCP) segment on
a PCIDSK database file (FILE). A 1 to 8-character identifier (DBSN)
must be specified for the GCP segment.<p>
The desired Ground Control Points file name can be determined using
the MBUREP program. All Ground Control Points files have the file
extension GCF.<p>
The Dipix BU file name is stored in the segment history record upon
completion of the data transfer.<p>
MBUGCP only reads ONE Ground Control Point file per run. So if you
want to read `N' ground control points segments from tape, you must
run MBUGCP `N' times, setting the appropriate parameters.<p>
A description of the Dipix tape format is given in the documentation
for the MBUREP program.
<P>
<PRE>
 A TAPE MUST BE MOUNTED ON THE TAPE DRIVE BEFORE MBUGCP CAN BE
 RUN.  CLEANING THE TAPE HEADS IS RECOMMENDED TO MINIMIZE THE
 CHANCE OF TAPE READ ERRORS.
</PRE>
<H3>EXAMPLE</H3>
Transfer GCP file H77GCPTS1.GCF from Dipix BU tape to database.
<P>
<PRE>
 EASI&gt;BUFILE=&quot;H77GCPTS1&quot;
 EASI&gt;FILE=&quot;H77GCPTS1.PIX&quot;
 EASI&gt;DBSN=&quot;Test&quot;
 EASI&gt;DBSD=
 EASI&gt;RUN MBUGCP
</PRE>
<hr>
<a href="http://www.pcigeomatics.com/dev_corner/pcihlp_gateway.html">About PCI Help Gateway</a>