捕捉 (编辑)—ArcGIS Pro

摘要

移动点或折点，使其与其他要素的折点、边或端点精确重合。可指定捕捉规则来控制是将输入折点捕捉到指定距离范围内的最近折点、边还是端点。

插图

使用情况

警告：

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

捕捉环境参数用于将输入要素的折点捕捉到多个图层或要素类的折点、边和端点。当提供多个捕捉规则时，它们的优先级为：在工具对话框中为从上到下，或在脚本中从左到右。
输入要素的折点将捕捉到指定距离范围内最近的折点、边或端点。
在捕捉环境参数中，可将同一个图层或要素类与不同的捕捉类型结合使用来指定多个捕捉规则。
如果将包含选择内容的图层或要素类用作输入，将仅捕捉所选要素的折点。
如果将某要素类中的要素捕捉到同一要素类中的要素，通常情况下，对象 ID 或要素 ID 较低的要素会被捕捉到对象 ID 较高的要素。（shapefile 的 OBJECTID 字段或 FID 字段）。例如，如果 OBJECTID 字段值为 1 和 2 的点位于捕捉距离范围内，则将 OBJECTID 字段值为 1 的点捕捉到 OBJECTID 字段值为 2 的点的位置（反之则不然）。

注：

此工具的一个使用案例是，通过将某个边界上的折点捕捉到另一边界的折点、边或端点来校正两个数据集间共享或公共边界的差异。如果输入要素中没有足够多的折点来匹配另一边界的准确曲率，可使用增密工具向输入要素添加折点，从而提高细节层次。

参数

标注	说明	数据类型
输入要素	折点将被捕捉到其他要素的折点、边或端点的输入要素。输入要素可以是点、多点、线或面。	Feature Layer
捕捉环境	输入包含要捕捉到的要素的要素类或要素图层。捕捉环境的组件如下：要素 - 要作为输入要素折点捕捉目标的要素。这些要素可以是点、多点、线或面。类型 - 可作为输入要素折点捕捉目标的要素部分的类型。距离 - 输入要素折点被捕捉到此距离范围内的最近端点、折点或边。可用捕捉类型如下：端点 - 将输入要素折点捕捉到要素末端。折点 - 将输入要素折点捕捉到要素折点。边 - 将输入要素折点捕捉到要素边。注：如果所用距离未带单位（如，输入 10 而不是 10 米），则默认情况下将使用输入要素的坐标系的线性单位或角度单位。如果输入要素使用投影坐标系，则将使用线性单位。	Value Table

标注

说明

数据类型

输入要素

折点将被捕捉到其他要素的折点、边或端点的输入要素。输入要素可以是点、多点、线或面。

Feature Layer

捕捉环境

输入包含要捕捉到的要素的要素类或要素图层。

捕捉环境的组件如下：

要素 - 要作为输入要素折点捕捉目标的要素。这些要素可以是点、多点、线或面。
类型 - 可作为输入要素折点捕捉目标的要素部分的类型。
距离 - 输入要素折点被捕捉到此距离范围内的最近端点、折点或边。

可用捕捉类型如下：

端点 - 将输入要素折点捕捉到要素末端。
折点 - 将输入要素折点捕捉到要素折点。
边 - 将输入要素折点捕捉到要素边。

注：

如果所用距离未带单位（如，输入 10 而不是 10 米），则默认情况下将使用输入要素的坐标系的线性单位或角度单位。如果输入要素使用投影坐标系，则将使用线性单位。

Value Table

派生输出

标注	说明	数据类型
捕捉到的输入要素	更新后的输入要素。	Feature Class

arcpy.edit.Snap(in_features, snap_environment)

名称	说明	数据类型
in_features	折点将被捕捉到其他要素的折点、边或端点的输入要素。输入要素可以是点、多点、线或面。	Feature Layer
snap_environment [[Features, Type, Distance],...]	输入包含要捕捉到的要素的要素类或要素图层。捕捉环境的组件如下：要素 - 要作为输入要素折点捕捉目标的要素。这些要素可以是点、多点、线或面。类型 - 可作为输入要素折点捕捉目标的要素部分的类型。距离 - 输入要素折点被捕捉到此距离范围内的最近端点、折点或边。可用捕捉类型如下： END - 将输入要素折点捕捉到要素末端。 VERTEX - 将输入要素折点捕捉到要素折点。 EDGE - 将输入要素折点捕捉到要素边。注：如果所用距离未带单位（如，输入 10 而不是 10 米），则默认情况下将使用输入要素的坐标系的线性单位或角度单位。如果输入要素使用投影坐标系，则将使用线性单位。	Value Table

名称

说明

数据类型

in_features

折点将被捕捉到其他要素的折点、边或端点的输入要素。输入要素可以是点、多点、线或面。

Feature Layer

snap_environment

[[Features, Type, Distance],...]

输入包含要捕捉到的要素的要素类或要素图层。

捕捉环境的组件如下：

要素 - 要作为输入要素折点捕捉目标的要素。这些要素可以是点、多点、线或面。
类型 - 可作为输入要素折点捕捉目标的要素部分的类型。
距离 - 输入要素折点被捕捉到此距离范围内的最近端点、折点或边。

可用捕捉类型如下：

END - 将输入要素折点捕捉到要素末端。
VERTEX - 将输入要素折点捕捉到要素折点。
EDGE - 将输入要素折点捕捉到要素边。

注：

Value Table

派生输出

名称	说明	数据类型
out_feature_class	更新后的输入要素。	Feature Class

代码示例

Snap 示例 1（Python 窗口）

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

import arcpy
arcpy.env.workspace = "C:/data"

arcpy.Snap_edit("climate.shp", 
                [["Habitat_Analysis.gdb/vegtype", "VERTEX", "30 Feet"], 
                 ["Habitat_Analysis.gdb/vegtype", "EDGE", "20 Feet"]])

Snap 示例 2（独立脚本）

将气候区域边界捕捉到植被图层边界以确保公共边界重合。

# Name: Snap.py
# Description: Snap climate regions boundary to vegetation layer boundary 
#              to ensure common boundary is coincident

# import system modules 
import arcpy

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

# Make backup copy of climate regions feature class, since modification with 
# the Editing tools below is permanent
climate = "climate.shp"
climateBackup = "C:/output/Output.gdb/climateBackup"
arcpy.CopyFeatures_management(climate, climateBackup)

# Densify climate regions feature class to make sure there are enough vertices 
# to match detail of vegetation layer when layers are snapped
arcpy.Densify_edit(climate, "DISTANCE", "10 Feet")

# Snap climate regions feature class to  vegetation layer vertices and edge
veg = "Habitat_Analysis.gdb/vegtype"

# First, snap climate region vertices to the nearest vegetation layer vertex 
# within 30 Feet
snapEnv1 = [veg, "VERTEX", "30 Feet"]

# Second, snap climate region vertices to the nearest vegetation layer edge 
# within 20 Feet
snapEnv2 = [veg, "EDGE", "20 Feet"]
arcpy.Snap_edit(climate, [snapEnv1, snapEnv2])

摘要

插图

使用情况

警告：

注：

参数

注：

派生输出

注：

派生输出

代码示例

环境

特殊情况

许可信息

相关主题

在本主题中