VECMERG

Description

Parameters

vecmerg(file, dbvs, dbsn, dbsd)

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.

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.

Return Value

Returns: Last Database Segment Created

Type:  PCI_INT

Parameter: lasc

Minimum Length: 0

This parameter will contain the segment number of the newly created vector segment.

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.

from pci.vecmerg import vecmerg

file = "irvine.pix"
dbvs = [25,26]
dbsn = "COMBINED"                           # new vector segment name
dbsd = "Merged vector segments 25 and 26"   # optional description
lasc = []				    # to get newly created vector segment

lasc = vecmerg (file, dbvs, dbsn, dbsd)