EDMATCH

Description

EDMATCH performs edge matching on two vector layers

Parameters

Name	Type	Length	Value range
InputReference: Input reference segment *	Vector port	1 - 1
InputVariable: Input variable vector segment *	Vector port	1 - 1
OutputA: Output edge-matched vector segment *	Vector port	1 - 1
Edge Tolerance *	Float	1 - 1
Node Tolerance *	Float	1 - 1
Merge Layers	String	0 - 1	TRUE | FALSE Default: FALSE
Remove Neatline	String	0 - 1	TRUE | FALSE Default: FALSE
Edge Snap Method	String	0 - 1	JOIN | SNAP Default: JOIN
Segment Description	String	0 - 1
Report	String	0 - 192	See parameter description

* Required parameter

Parameter descriptions

InputReference: Input reference segment

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.

InputVariable: Input variable vector segment

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.

OutputA: Output edge-matched vector segment

Specifies the vector segment to receive the edge-matched output vector layer.

This output layer may be either a combination of the two input layers, or an edited version of the input variable layer, depending on the value set in the Merge Layers parameter.

Edge Tolerance

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.

Node Tolerance

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.

Merge Layers

Specifies how to create the edge-matching output.

Remove Neatline

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.

Edge Snap Method

Specifies how to perform the edge matching on the line.

Segment Description

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:

• LOG: generates a report on the terminal (default)
• <modulename.RPT>: appends a report to the module's RPT file
• DISK: generates a report on file "IMPRPT.LST"

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.