描述
此工具可将线段延伸至指定距离范围内的第一个相交要素。如果在指定距离范围内不存在相交的要素,则不会延伸该线段。工具用于完成质量控制任务,例如,清除在未设置适合的捕捉环境的情况下而进行数字化的要素中的拓扑错误。
插图
使用方法
如果未指定延伸长度,线段将延伸至第一个相交要素。
如果使用延伸到扩展项选项,则线段可延伸至现有线要素以及指定延伸长度范围内的其他延伸线段,从而形成两个扩展项的交点。
如果要素是第一个相交要素,则可将此要素延伸至本身。
如果将包含选择内容的要素图层或要素类用作输入,则将仅延伸所选的要素。该图层或要素类中的所有要素将用来评估是否可执行延伸,但仅修改所选的要素。
此工具不会更改任何要素属性,但个人地理数据库要素类、文件地理数据库要素类或 SDE 地理数据库要素类中的管理几何(长度)字段除外。
警告:
此工具会修改输入数据。有关详细信息以及避免数据被意外更改的策略,请参阅修改或更新输入数据的工具。
语法
arcpy.edit.ExtendLine(in_features, {length}, {extend_to})
参数 | 说明 | 数据类型 |
in_features | 要延伸的线输入要素。 | Feature Layer |
length (可选) | 线段延伸到相交要素所需的最大距离。 | Linear Unit |
extend_to (可选) | 控制线段是否可延伸至指定延伸长度范围内的其他延伸线段。
| Boolean |
派生输出
名称 | 说明 | 数据类型 |
out_feature_class | 更新后的输入要素。 | 要素类 |
代码示例
下面的 Python 窗口脚本演示了如何使用 ExtendLine 工具。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.ExtendLine_edit("majorrds.shp", "15 Feet", "EXTENSION")
清除在未设置相应捕捉环境的情况下进行数字化的街道中心线。
# 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: 是