VECREP -- Vector Segment Report


<HEAD><TITLE>VECREP -- Vector Segment Report</TITLE></HEAD>


<H1>VECREP -- Vector Segment Report</H1>
Writes the contents of a vector segment to a report device.
<P>
<H3>PARAMETERS</H3>
VECREP is controlled by the following global parameters:
<P>
<pre>Name     Prompt                                  Count     Type
FILE     Database File Name                      1-64      Char
DBVS     Database Vector Segment                 1         Int
VRTYPE   Vector Report Contents                  0-16      Char
REPORT   Report Mode: TERM/OFF/filename          1-64      Char
</pre>
<H4>FILE</H4>
Specifies the PCIDSK database file containing the vector segment.
<P>
<PRE>
 EASI&gt;FILE=&quot;filespec&quot;
</PRE>
<H4>DBVS</H4>
Specifies the database vector segment to be dumped to the report
device.
<P>
<PRE>
 EASI&gt;DBVS=i
</PRE>
NOTE: Segment must be type 116.
<P>
<H4>VRTYPE</H4>
<PRE>
  Valid Values:   VERT, TABLE, RST, ALL, SUMMARY, OLD
  Default:        SUMMARY
</PRE>
Specifies the type of vector segment report to be generated. It can
be any of the following values. Short forms can be used.
<P>
<UL>
<LI> VERT: The report contains only the vertices of the shapes, and
the projection. 
<LI> TABLE: The report contains only the attribute table. 
<LI> RST: The report contains only the Representation Style Table. 
<LI> ALL: The report contains the vertices, attributes and RST
(default). 
<LI> SUMMARY: The report contains the projection, number of
structures, and other short summary information, but none of the
RST, Vertices or Attribute information. Includes field types, and
formats. 
<LI> OLD: Produces a report similar to the pre-V6.0 format. This
contains the vertices (without a Z coordinate, and the first two
attributes. 
</UL>
<H4>REPORT</H4>
Specifies the file to which to append the generated report.
<P>
<PRE>
 EASI&gt;REPORT=&quot;filename&quot;
 EASI&gt;REPORT=           | defaults to terminal output
</PRE>
The following names have special meaning:
<P>
<PRE>
 EASI&gt;REPORT=&quot;TERM&quot;     | generates reports on your terminal.
 EASI&gt;REPORT=&quot;DISK&quot;     | generates reports on file &quot;IMPRPT.LST&quot;.
 EASI&gt;REPORT=&quot;OFF&quot;      | usually cancels report generation, but
                        | VECREP forces REPORT to terminal output
</PRE>
<H3>DETAILS</H3>
VECREP writes the contents of a vector segment (DBVS) held in a
PCIDSK database (FILE) to a report device (REPORT).<p>
A report device (REPORT parameter) must be selected. If the report
device is OFF, VECREP will force its output to the user's terminal.<p>
If vector coordinates are stored in LONG/LAT units, then coordinates
are reported as degrees, minutes, seconds, and hemisphere, rather
than real numbers.<p>
Note: Vector segments can contain very large amounts of data and may
result in reports hundreds of pages long.
<P>
<H3>EXAMPLE</H3>
Print a report of the attribute table in vector segment 25 on the
demo file irvine.pix to the report file vectors.lis.
<P>
<PRE>
 EASI&gt;FILE=&quot;irvine.pix&quot;
 EASI&gt;DBVS=25                   | specify segment to print
 EASI&gt;VRTYPE=&quot;table&quot;            | print only the attribute table
 EASI&gt;REPORT=&quot;vectors.lis&quot;      | specify file to receive data
 EASI&gt;DELETE &quot;vectors.lis&quot;      | delete any existing report
 EASI&gt;RUN VECREP
</PRE>
Following is a portion of the resulting file contents:
<P>
<PRE>
 Shape Attribute    Group
     0   1700210        1
     1   1700210        2
     2   1700205        3
     3   1700210        4
     4   1700210        5
     5   1700210        6
     6   1700211        7
     7   1700211        8
     8   1700210        9
     9   1700210       10
    10   1700210       11
           ...
</PRE>
<hr>
<a href="http://www.pcigeomatics.com/dev_corner/pcihlp_gateway.html">About PCI Help Gateway</a>