Split Line At Vertices (Data Management)

Summary

Creates a feature class containing lines that are generated by splitting input lines or polygon boundaries at their vertices.

Illustration

Usage

• The attributes of the input features will be maintained in the output feature class.

• If an input line has no vertices between its start and end points, it will be copied to the output as it is; otherwise, every segment between two consecutive vertices will become a line feature in the output. Similarly, every segment between two consecutive vertices along a polygon boundary will become a line feature in the output. The output feature class can be a much larger file, depending on how many vertices the input features have.

• A parametric (true) curve line or segment will not be densified and will remain true curve as an output line feature. This does not apply to shapefile data.

• The function name of this tool in scripting is SplitLine, not SplitLineAtVertices.

Syntax

SplitLine_management (in_features, out_feature_class)

Parameter	Explanation	Data Type
in_features	The input features that can be line or polygon.	Feature Layer
out_feature_class	The output line feature class.	Feature Class

Code Sample

SplitLine Example 1 (Python window)

The following Python window script demonstrates how to use the SplitLine function in immediate mode.

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.SplitLine_management("roads.shp", "c:/output/output.gdb/roads_split")

SplitLine Example 2 (stand-alone script)

The following stand-alone script is a simple example of how to apply the SplitLine function in a scripting environment.

# Name: SplitLine_Example2.py
# Description: Split a bus line feature at its vertices (bus stops)
#              and find a midpoint of each new line for further analysis.
# Author: ESRI
 
# import system modules 
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"
 
# Set local variables
inFeatures = "buslines.shp"
outFeatureClass = "c:/output/output.gdb/buslines_segments"
midPtsFeatureClass = "c:/output/output.gdb/buslines_segments_midPts"

# Run SplitLine to get new lines, each of which is between two bus stops
arcpy.SplitLine_management(inFeatures, outFeatureClass)

# Execute FeatureVerticesToPoints to find a midpoint for every new line
arcpy.FeatureVerticesToPoints_management(outFeatureClass,
                                         midPtsFeatureClass, "MID")

# Comments: You may add attribute information, such as driving time,
#           to the midpoint feature class and display the attributes 
#           as an alternative label for each line between two bus stops.

Environments

Current Workspace, Scratch Workspace, Default Output Z Value, M Resolution, M Tolerance, Output M Domain, Output Z Domain, Output Coordinate System, Extent, Output has M values, Output has Z values, Output Spatial Grid 1, Output Spatial Grid 2, Output Spatial Grid 3, XY Resolution, XY Tolerance, Z Resolution, Z Tolerance

Licensing Information

ArcGIS for Desktop Basic: No

ArcGIS for Desktop Standard: No

ArcGIS for Desktop Advanced: Yes