摘要
分析一个或多个要素类中要素之间的要素折点的坐标位置。彼此间距离在指定范围内的折点被认为表示同一个位置,并被指定一个共有坐标值(换句话说,将它们定位于同一点)。该工具还会在要素折点位于边的 x,y 容差范围内以及线段相交的位置处添加折点。
整合可执行以下处理任务:
- 位于彼此 x,y 容差内的折点将被分配相同的坐标位置。
- 如果一个要素的折点位于任何其他要素的边的 x,y 容差范围内,则将在边上插入新折点。
- 如果线段相交,则将在相交中涉及的每个要素的相交点处插入一个折点。
插图
用法
如果选中了任何输入要素,则仅会针对那些所选要素执行该工具。
该工具执行的任务与拓扑相同,因为该工具将在 x,y 容差范围内移动要素并在要素相交的位置插入折点。考虑使用拓扑来执行此类操作的原因是:对于拓扑,您可以指定建立要素间关联的规则和条件。有关使用拓扑的详细信息,请参阅拓扑基础知识。
在以下情况中可以选择使用整合而非拓扑:
- 不需要指定要素的移动规则,只需在指定的容差范围内合并所有要素。
- 要在各条线的所有相交处都添加折点。
- 处理的是非地理数据库要素(如 shapefile)或者不同地理数据库中的要素(拓扑中的要素必须全属于同一要素数据集)。
整合期间,可以解决数据中存在的许多潜在问题。其中包括极小的过失或未及的处理、重复线段的自动分离删除以及沿边界线的坐标稀疏化。
建议您不要使用 XY 容差工具参数。如果未指定该参数,则工具将使用输入要素类空间参考以确定整合期间要使用的 x,y 容差。输入数据空间参考应设置为其默认 x,y 分辨率和 x,y 容差。有关空间参考的详细信息,请参阅空间参考的属性。
XY 容差参数不适用于概化几何形状;而适用于整合线条和边界。运行整合工具可以最大限度地减少在后续拓扑操作(例如叠加和融合)期间的数据移动量。
XY 容差的值至关重要。有关聚类处理的详细信息,请参阅聚类处理。
整合仅支持将简单要素类作为输入(点、多点、线或面)。
要撤销对输入要素做出的更改,请在编辑会话中使用整合。
处理各要素的折点数较多的数据集时(例如,单个要素中包含成千上万甚至上百万个折点),一些几何处理操作可能会导致内存不足。有关详细信息,请参阅对大型数据集进行地理处理。
该工具的输出数据元素属于一种派生的多值输出。要将该工具的输出用于其他工具,请直接使用该工具的输入并将该工具的输出设置为其他工具的前提条件。了解有关设置前提条件的详细信息。
语法
Integrate_management (in_features, {cluster_tolerance})
参数 | 说明 | 数据类型 |
in_features [[Feature Layer, Long],...] | 要整合的要素类。如果要素间的距离小于容差,则折点或点将被聚类(移动至重合状态)。等级较低的要素类或图层将捕捉到等级较高的要素类或图层中的要素(其中 1 级高于 2 级)。如果使用的 x,y 容差较大,则等级为 1 的要素类中的要素甚至也可能发生移动。有关详细信息,请参阅优先级等级和地理处理工具。 | Value Table |
cluster_tolerance (可选) | 该距离可确定一个范围,要素折点将在此范围内实现重合。要最大限度的减少不必要的折点移动,x,y 容差应该非常小。如果未指定任何值,则将使用输入列表中第一个数据集的 xy 容差。建议您不要设置此参数,并允许 x,y 容差默认为数据的空间参考 x,y 容差。 | Linear Unit |
派生输出
名称 | 说明 | 数据类型 |
out_features |
代码示例
Integrate 示例 1(Python 窗口)
以下 Python 窗口脚本演示了如何在即时模式下使用 Integrate 函数。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CopyFeatures_management("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.Integrate_management("C:/output/output.gdb/vegtype", 0.01)
Integrate 示例 2(独立脚本)
下面的独立脚本演示了如何在脚本环境中应用 Integrate 函数。
# Description: Run Integrate on a feature class
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"
# Set local variables
inFeatures = "vegtype"
integrateFeatures = "C:/output/output.gdb/vegtype"
xyTolerance = "0.1 feet"
# Execute CopyFeature (since Integrate modifies the original data
# this ensures the original is preserved)
arcpy.CopyFeatures_management(inFeatures, integrateFeatures)
# Execute Integrate
arcpy.Integrate_management(integrateFeatures, xyTolerance)
环境
许可信息
- ArcGIS Desktop Basic: 是
- ArcGIS Desktop Standard: 是
- ArcGIS Desktop Advanced: 是