Insert Vertices

Title Insert Vertices

Summary

Splits or adds vertices to a polyline feature when the line feature is within the specified buffer distance of an input point feature and none of the polyline's vertices are within this distance. Optionally moves the polyline vertex nearest an input point to the input point's location and deletes all other polyline vertices located within the specified buffer distance of the input point.

Usage

If the input polyline features is a layer having a selection set, only the selected features are used.
If the input point features is a layer having a selection set, only the selected features are used.
The input point features can be either a point of polyline feature class or layer. For polylines, the two endpoints are used as the point inputs.
This tool will operate on all polyline features within the specified buffer distance of a point.
This tool modifies the input data. If you do not wish to permanently modify your data, you should export the data to another feature class and execute this tool on the copy.
When inserting points, the z-coordinate of the point features will be assigned to the point inserted into the polyline provided that both the polyline and point features are defined to store z-values. The z-coordinate will be factored to the units of the vertical coordinate system of the polyline when the polyline and point features both have defined vertical coordinate systems.

Syntax

Insert_Vertices (input_polylinefeatures, input_pointfeatures, input_pointfeatures_buffer_field, input_nullbuffervalue, input_insertorsplit, input_projectonto, input_newparts, input_MovePoints, output_work_summary_table)

Parameter	Explanation	Data Type
input_polylinefeatures	Dialog Reference The polyline features from a feature class or layer whose shapes will be modified by moving, removing, or inserting a vertices, or by splitting. There is no python reference for this parameter.	Feature Layer
input_pointfeatures	Dialog Reference The feature class or layer whose shapes provide the points used to move, remove, or insert vertices or split one or more polyline features. This input can be either a point or polyline shaped feature class. When polylines are used, only the two endpoints are uses as input points. There is no python reference for this parameter.	Feature Layer
input_pointfeatures_buffer_field	Dialog Reference The field in the point features that specifies the maximum distance a polyline can be from a point for it to be operated on. This field allows each point feature to have a different buffer value. When the field value is Null, the value specified in the Null Value Buffer is used. The field can be any of the following numeric types: short integer, integer, single, or double. There is no python reference for this parameter.	Field
input_nullbuffervalue	Dialog Reference Specifies the maximum distance a polyline can be from a point for it to be operated on when the point feature's buffer field value is Null. There is no python reference for this parameter.	Double
input_insertorsplit	Dialog Reference Specify if the points will be used to insert a vertex into the polylines or to split them. INSERT - A new vertex will be added to the polyline. SPLIT - The polyline will be split into two polylines. ___________________ Python Reference Specify if the points will be used to insert a vertex into the polylines or to split them. INSERT - A new vertex will be added to the polyline. SPLIT - The polyline will be split into two polylines.	String
input_projectonto	Dialog Reference Specifies if the point will be projected onto the polyline when inserting a new vertex. This option is disabled when splitting polylines. Checked - The point will be projected onto the polyline if it is not already on the polyline. Unchecked - The point will not be projected onto the polyline. By default lines are going to attach to points. ___________________ Python Reference Specifies if the point will be projected onto the polyline when inserting a new vertex. This option is disabled when splitting polylines. PROJECT_ONTO - The point will be projected onto the polyline if it is not already on the polyline. NO_PROJECT_ONTO - The point will not be projected onto the polyline. By default lines are going to attach to points.	Boolean
input_newparts	Dialog Reference Specifies if new parts will be created when inserting a new vertex. This option is disabled when splitting polylines. Checked - The part on which the point falls is split into two parts with the newly added vertex serving as the end of the first part and the beginning of the second. Unchecked - The part on which the point falls is not split into two parts. A new vertex is created on the part on which the point falls. ___________________ Python Reference Specifies if new parts will be created when inserting a new vertex. This option is disabled when splitting polylines. CREATE_PARTS - The part on which the point falls is split into two parts with the newly added vertex serving as the end of the first part and the beginning of the second. NO_CREATE_PARTS - The part on which the point falls is not split into two parts. A new vertex is created on the part on which the point falls.	Boolean
input_MovePoints	Dialog Reference Specifies if the nearest polyline vertex located within the specified buffer distance of a point should be moved to the point and other vertices within the buffer distance removed. The moved vertex will retain its original measure value. Only the positional values (x, y, and z) will be changed. Checked - The nearest polyline vertex located within the specifed buffer distance will be moved and all other vertices within the buffer distance will be removed. Unchecked - No polyline vertices will be moved or removed. ___________________ Python Reference Specifies if the nearest polyline vertex located within the specified buffer distance of a point should be moved to the point and other vertices within the buffer distance removed. The moved vertex will retain its original measure value. Only the positional values (x, y, and z) will be changed. MOVE_POINTS - The nearest polyline vertex located within the specifed buffer distance will be moved and all other vertices within the buffer distance will be removed. NO_MOVE_POINTS - No polyline vertices will be moved or removed.	Boolean
output_work_summary_table	Dialog Reference Specifies the location of an output table that will summarize the work done by the tool. This table describes the date and time that the tool was executed (RunDateTime), the number of vertices affected by a point on a polyline feature (VertexCount), and the maximum distance between the point and the polyline vertices located within the buffer tolerance (MaxDistance). There is no python reference for this parameter.	Table

Code Samples

There are no code samples for this tool.

Tags

insert

Credits

There are no credits for this item.

Use limitations

There are no use limitations for this item.