Extend Line (Editing Tools)

Summary

Extends line segments to the first intersecting feature within a specified distance. If no intersecting feature is within the specified distance, the line segment will not be extended. Tool use is intended for quality control tasks such as cleaning up topology errors in features that were digitized without having set proper snapping environments.

Illustration

Extend Line tool illustration

Usage

Caution:

This tool modifies the input data. See Tools that modify or update the input data for more information and strategies to avoid undesired data changes.

When no Extend Length parameter value is specified, segments will be extended to the first intersecting feature.
When an Extend to Extensions parameter value is specified, line segments can be extended to existing line features as well as to other extended line segments within the specified extend length, forming intersections between two extensions.
A feature can be extended to itself if it is the first intersecting feature.
When a feature layer or feature class with a selection is used as the input, only the selected features will be extended. All features in the layer or feature class will be used to assess if an extension can be performed, but only the selected features will be modified.
This tool will not change any feature attributes, except the managed geometry (length) fields in a file, or enterprise geodatabase feature class.

Label	Explanation	Data type
Input Features	The line input features that will be extended.	Feature Layer
Extend Length (Optional)	The maximum distance a line segment can be extended to an intersecting feature.	Linear Unit
Extend to Extensions (Optional)	Specifies whether line segments can be extended to other extended line segments within the specified extend length. Checked—Line segments can be extended to other extended line segments as well as existing line features. This is the default. Unchecked—Line segments can only be extended to existing line features.	Boolean

Derived output

Label	Explanation	Data type
Updated Input Features	The updated input features.	Feature Class

arcpy.edit.ExtendLine(in_features, {length}, {extend_to})

Name	Explanation	Data type
in_features	The line input features that will be extended.	Feature Layer
length (Optional)	The maximum distance a line segment can be extended to an intersecting feature.	Linear Unit
extend_to (Optional)	Specifies whether line segments can be extended to other extended line segments within the specified extend length. `EXTENSION`—Line segments can be extended to other extended line segments as well as existing line features. This is the default. `FEATURE`—Line segments can only be extended to existing line features.	Boolean

Derived output

Name	Explanation	Data type
out_feature_class	The updated input features.	Feature Class

Code sample

ExtendLine example 1 (Python window)

The following Python window script demonstrates how to use the ExtendLine function.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.edit.ExtendLine("majorrds.shp", "15 Feet", "EXTENSION")

ExtendLine example 2 (stand-alone script)

Clean up street centerlines that were digitized without having set proper snapping environments

# Name: ExtendLine.py
# Description:  Clean up street centerlines that were digitized without
#               having set proper snapping environments.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Make backup copy of streets feature class, since modification with
# the Editing tools below is permanent
streets = "majorrds.shp"
streetsBackup = "C:/output/Output.gdb/streetsBackup"
arcpy.management.CopyFeatures(streets, streetsBackup)

# Trim street lines to clean up dangles
arcpy.edit.TrimLine(streets, "10 Feet", "KEEP_SHORT")

# Extend street lines to clean up dangles
arcpy.edit.ExtendLine(streets, "15 Feet", "EXTENSION")

Environments

Extent, Current Workspace

Licensing information

Basic: No
Standard: Yes
Advanced: Yes

Extend Line (Editing Tools)

Summary

Illustration

Usage

Caution:

Parameters

Derived output

Environments

Licensing information

Related topics