VECMERG

Description

VECMERG merges two or more vector segments in a PCIDSK file and writes the result to a new vector segment.

Parameters

Name	Type	Caption	Length	Value range
FILE *	String	File name	1 - 192
DBVS *	Integer	Input vector segments or layers	2 - 64
DBSN *	String	Output vector segment or layer name	1 - 8
DBSD	String	Output vector segment or layer description	0 - 64
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 name of the PCIDSK file containing the vector segments.

DBVS

Specifies two or more vector segments or layers to be merged.

Duplicates are not allowed.

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.

DBSN

Specifies a name (up to 8 characters) for the merged vector segment or layer.

DBSD

Describes (in up to 64 characters) the contents or origins of the output data.

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

VECMERG merges a set of vector segments or layers and saves the merged data set in a new vector segment or layer. The vectors used as input are not changed. The output vector is given the name and description specified by the DBSN (Vector Layer Name) and DBSD (Vector Layer Description) parameters.

The LASC will be returned with the segment number of the newly created vector segment.

All vectors specified by DBVS (Input) must be in the same units (such as PIXEL or UTM).

If the tables are set up differently, VECMERG will merge the tables together. This may result in a very large table.

The Representation Table of the newly created vector segment is copied from the first segment specified.

Example

Merge the two vector segments (25 and 26) in irvine.pix into one new segment.

EASI>FILE    = "irvine.pix"
EASI>DBVS    = 25,26
EASI>DBSN    = "COMBINED"    ! new vector segment name
EASI>DBSD    = "Merged vector segments 25 and 26"   ! optional description
EASI>REPORT  = "DISK"
EASI>MONITOR = "ON"
EASI>RUN VECMERG