Go to ET GeoWizards 12.x User Guide
Polyline Global Snap
Go to ToolBox
Implementation
Snaps the features of a polyline layer to another layer (Point, Polyline or Polygon)
Inputs:
- A polyline layer to be snapped
- A snap layer - point, polyline or polygon
- Snap tolerance
- Snap options1 (Snap What)
- Snap options2 (Snap To What)
- Snap to reference Z values (only if the input and output are Z enabled)
Outputs:
- A polyline feature class - the polylines from the source layer will be moved to snap to the
features of the Snap Layer (if within the snap tolerance)
Options:
- Snap Options 1 (Snap What) - this options lets the user set which elements of the source
polylines to be used for snapping
- Nodes: Only nodes (end points) of the polylines will be snapped
- Vertices: All the vertices of the source polylines will be used.
- Insert Vertices: This option will get the vertices from the features of the snap layer
and will insert new vertices into the source polylines. The new vertices together with the
original ones will be used for snapping. This option is slower than the other ones, but
gives the best snapping results especially if the polylines to be snapped have much less
vertices than the ones from the Snap layer.
- Snap Options 2 (Snap To What)
- Vertices: The polylines will be snapped to the nearest vertex of the nearest feature
from the Snap layer
- Nearest edge: The polylines will be snapped to the nearest point of the nearest feature
from the Snap layer
- Vertices & Edges: If there is a vertex closer than the snap tolerance to the
polylines (their elements defined in Options 1) to be snapped, the polyline will snap to
it, otherwise it will snap to the nearest edge.
- Snap to Z
Notes:
- The snap distance should be in the units of the input dataset.
- The Source and the Snap datasets can have different spatial references as long as they
have the same Geographic Coordinate systems.
Example: Red - Source Polyline; Black - Snap Polyline; Green - Snapped
Polyline
Before Snap |
After Snap
Option1: Nodes
Option2: Vertices |
After Snap
Option1: Vertices
Option2: Vertices |
After Snap
Option1: Insert Vertices
Option2: Vertices & Edges |

|

|

|

|
ToolBox
implementation
(Go to TOP)
Command line syntax
ET_GPSnapPolylines <input_dataset>
<Reference_dataset> <out_feature class> <snap_tolerance> <snap_what>
{snap_to_vertices} {snap_to_nearest}
Parameters
Expression |
Explanation |
<input_dataset> |
A
Polyline feature class or feature layer |
<Reference_dataset> |
A
Point, Polyline or Polygon feature class or feature layer.
|
<out_feature_class> |
A String
- the full name of the output feature class (A feature class with the same full
name should not exist) |
<snap_tolerance> |
A Double representing the Search
tolerance (in the units of the input_dataset) to be used |
<snap_what> |
A
String indicating what parts of the input polylines will be snapped.
Possible values:
- Nodes: Only nodes (end points)
of the polylines will be snapped
- Vertex: All the vertices of the
source polylines will be used.
- Insert: This option will get
the vertices from the features of the Reference_dataset
and will insert new vertices into the source polylines. The new
vertices together with the original ones will be used for snapping.
This option is slower than the other ones, but gives the best
snapping results especially if the polylines to be snapped have much
less vertices than the ones from the Reference_dataset.
|
{snap_to_vertices} |
A
Boolean indicating whether snapping to the closest vertex of the nearest
feature from the Reference_dataset to be used |
{snap_to_nearest} |
A
Boolean indicating whether snapping to the nearest point of the nearest
feature from the Reference_dataset to be used |
Scripting syntax
ET_GPSnapPolylines (input_dataset,
Reference_dataset, out_feature_ class, snap_tolerance,
snap_what,snap_to_vertices, snap_to_nearest)
See the explanations above:
<> - required parameter
{} - optional parameter
Copyright © Ianko Tchoukanski |