EDMATCH

Description

EDMATCH performs edge matching on two vector layers

Parameters

Name	Type	Caption	Length	Value range
FILREF	String	Input reference file name	0 - 192
FILI *	String	Input file name	1 - 192
FILO	String	Output file name	0 - 192
DBRS *	Integer	Input reference segment	1 - 1
DBVS *	Integer	Input variable vector segment	1 - 1
EDGETOL *	Float	Edge tolerance value	1 - 1
NODETOL *	Float	Node tolerance value	1 - 1
MRGLYR	String	Merge layers	0 - 5	TRUE | FALSE Default: FALSE
RMNTLINE	String	Remove neat line	0 - 5	TRUE | FALSE Default: FALSE
EDGESNAP	String	Edge snapping method	0 - 4	JOIN | SNAP Default: JOIN
DBSN	String	Output segment name	0 - 8	Default: Vectors
DBSD	String	Output segment 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

FILREF

Specifies the name of the PCIDSK file containing the input reference layer to be used.

FILI

Specifies the name of the PCIDSK file containing the input line or polygon layers on which to perform edge matching.

FILO

Specifies the name of the PCIDSK image file to receive the edge-matched output vector layer.

If FILO is not specified, FILI is used for the output vector. If FILO is specified but does not exist, a new file is created.

DBRS

Specifies the vector segment that contains the reference arc layer. Vertices on the edge in this layer will not be modified; the file is used strictly as a reference.

DBVS

Specifies the vector segment containing the variable arc layer to be edge-matched. Vertices on the edge in this layer will be modified, based on the reference layer.

EDGETOL

Specifies the edge tolerance value, used to locate the dangles along the edge. Any vertex in this range is considered a candidate for matching.

The tolerance can be no greater than 20 percent of the width or height of the layer extending from the edge being matched.

NODETOL

Specifies the node tolerance value, used to determine which nodes are to be snapped.

If MRGLYR (Merge Layers) is True (checked), two nodes on the edges within the specified tolerance will be merged. If MRGLYR is False (unchecked), the node on the variable layer will move to the same location as the node on the reference layer.

MRGLYR

Specifies how to create the edge-matching output.

RMNTLINE

Specifies whether to remove the neatline when creating the output.

This option applies only to LINE layers. The neatline is always removed when matching polygon layers.

EDGESNAP

Specifies how to perform the edge matching on the line.

DBSN

Specifies a name (up to 8 characters) for the output vector segment.

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

EDMATCH matches two input vector layers and creates a new output layer. The output layer may be either a merged output of the two input layers or an edited version of one of the layers. Matching may be performed on layers that have either horizontal or vertical edges.

This algorithm supports matching of Line or Whole Polygon layers. Both input layers must be the same type of vector layer. When using the Merge Layers option, the layers must also have the same attributes in the attribute table.

EDMATCH first tries to find edge shapes, then tries to match vertices and nodes on the edge in the variable layer with the vertices on the edge in the reference layer, if they are within the specified tolerance levels.

EDMATCH then traverses shapes by their edge vertices and nodes to cross the boundary and form a combined shape.

Example

Match two vector layers from the file "edmatch.pix" and create an output file named "oedgematch.pix".

EASI>FILREF   = "edmatch.pix"
EASI>FILI     = "edmatch.pix"
EASI>FILO     = "oedmatch.pix"
EASI>DBRS     = 2
EASI>DBVS     = 3            ! DBVS cannot be equal to DBRS
EASI>EDGETOL  = 0.1     
EASI>NODETOL  = 0.1     
EASI>MRGLYR   =				! Defaults to FALSE 
EASI>RMNTLINE =				! Defaults to FALSE 
EASI>EDGESNAP =				! Defaults to JOIN
EASI>DBSN     =				! Defaults to Vectors
EASI>DBSD     =				! Will be taken from DBVS
EASI>REPORT   =				! Defaults to TERM
EASI>MONITOR  =				! Defaults to ON

EASI>run edmatch