延伸线 (编辑)

描述

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

插图

“延伸线”图示

使用方法

    警告:

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

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

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

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

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

  • 此工具不会更改任何要素属性,但个人地理数据库要素类、文件地理数据库要素类或 SDE 地理数据库要素类中的管理几何(长度)字段除外。

语法

arcpy.edit.ExtendLine(in_features, {length}, {extend_to})
参数说明数据类型
in_features

要延伸的线输入要素。

Feature Layer
length
(可选)

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

Linear Unit
extend_to
(可选)

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

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

派生输出

名称说明数据类型
out_feature_class

更新后的输入要素。

要素类

代码示例

ExtendLine 示例 1(Python 窗口)

下面的 Python 窗口脚本演示了如何使用 ExtendLine 工具。

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.ExtendLine_edit("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.CopyFeatures_management(streets, streetsBackup)
# Trim street lines to clean up dangles
arcpy.TrimLine_edit(streets, "10 Feet", "KEEP_SHORT")
# Extend street lines to clean up dangles
arcpy.ExtendLine_edit(streets, "15 Feet", "EXTENSION")

许可信息

  • Basic: 否
  • Standard: 是
  • Advanced: 是

相关主题