延伸线 (编辑)

摘要

将线段延伸至指定距离范围内的第一个相交要素。 如果在指定距离范围内不存在相交的要素,则不会延伸该线段。 工具用于完成质量控制任务,例如,清除在未设置适合的捕捉环境的情况下而进行数字化的要素中的拓扑错误。

插图

延伸线图示

使用情况

    警告:

    此工具会修改输入数据。 有关详细信息以及避免数据被意外更改的策略,请参阅修改或更新输入数据的工具

  • 如果未指定延伸长度参数,线段将延伸至第一个相交要素。

  • 如果使用延伸到扩展项参数,则线段可延伸至现有线要素以及指定延伸长度范围内的其他延伸线段,从而形成两个扩展项的交点。

  • 如果要素是第一个相交要素,则可将此要素延伸至本身。

  • 如果将包含选择内容的要素图层或要素类用作输入,则将仅延伸所选的要素。 该图层或要素类中的所有要素将用来评估是否可执行延伸,但仅修改所选的要素。

参数

标注说明数据类型
输入要素

要延伸的线输入要素。

Feature Layer
延伸长度
(可选)

线段延伸到相交要素所需的最大距离。

Linear Unit
延伸到扩展项
(可选)

指定线段是否可延伸至指定延伸长度范围内的其他延伸线段。

  • 选中 - 线段可延伸至其他延伸线段以及现有线要素。 这是默认设置。
  • 未选中 - 线段只能延伸至现有线要素。
Boolean

派生输出

标注说明数据类型
更新后的输入要素

更新后的输入要素。

Feature Class

arcpy.management.ExtendLine(in_features, {length}, {extend_to})
名称说明数据类型
in_features

要延伸的线输入要素。

Feature Layer
length
(可选)

线段延伸到相交要素所需的最大距离。

Linear Unit
extend_to
(可选)

指定线段是否可延伸至指定延伸长度范围内的其他延伸线段。

  • EXTENSION线段可延伸至其他延伸线段以及现有线要素。 这是默认设置。
  • FEATURE线段只能延伸至现有线要素。
Boolean

派生输出

名称说明数据类型
out_feature_class

更新后的输入要素。

Feature Class

代码示例

ExtendLine 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何使用 ExtendLine 函数。

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.edit.ExtendLine("majorrds.shp", "15 Feet", "EXTENSION")
ExtendLine 示例 2(独立脚本)

清除在未设置相应捕捉环境的情况下进行数字化的街道中心线。

# 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")