VECREP

Description

Generates a report describing the contents of a specified vector segment.

Note: VECREP does not support topological polygon layers as input. You can convert topological polygons into whole polygons using TPOLY2POLY.

Parameters

Name	Type	Caption	Length	Value range
FILE*	String	Input file name	1 - 192
DBVS*	Integer	Input vector segment	1 -
VRTYPE	String	Vector report type	0 - 8	Default: SUMMARY
REPORT	String	Report mode	0 - 192	Quick links
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILE

Specifies the PCIDSK image file that contains the vector segment to describe.

DBVS

Specifies the input vector segment to be described in the the report.

Note: The input vector segment must be type 116.

Ranges of channels or segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}. When you are not specifying a range in this way, only 48 numbers can be specified explicitly.

VRTYPE

Specifies the type of vector segment report to be generated.

Supported types are:

VERT: report contains only the vertices of the shapes, and the projection
TABLE: report contains only the attributes table
RST: report contains only the Representation Style Table
ALL: report contains all vertices, attributes, and RST; this is the default value
SUMMARY: 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.
OLD: report contains vertices (without a Z coordinate) and the first two attributes.

REPORT

Specifies where to direct the generated report.

Available options are:

TERM: generates a report on the terminal (default)
DISK: generates a report on file "IMPRPT.LST"
OFF: turns off report generation
<filename>: appends a report to the specified file

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

ON: Turns the monitor ON (default)
OFF: Turns the monitor OFF (recommended if running in batch or background mode)

Details

VECREP writes the contents of the input vector segment (DBVS) held in a PCIDSK image file to the defined report device.

A report device must be selected. If the report device is OFF, VECREP will force its output to the user's terminal.

If vector coordinates are stored in LONG/LAT units, coordinates are reported as degrees, minutes, seconds, and hemisphere, rather than in real numbers.

Note: Because vector segments can contain very large amounts of data, this operation may result in reports hundreds of pages long.

Example

Print a report of the attribute table in vector segment 25 on the demo file irvine.pix to the report file vectors.lis.

EASI>file	=	'irvine.pix'	! input file
EASI>dbvs	=	25,26	! input vector segments
EASI>vrtype	=	'TABLE'	! report type

EASI>RUN VECREP

Following is a portion of the resulting file contents:

 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
           ...

Environments	PYTHON :: EASI :: MODELER
Quick links	Description :: Parameters :: Parameter descriptions :: Details :: Example