描述
分析一个或多个要素类中要素之间的要素折点的坐标位置。彼此间距离在指定范围内的折点被认为表示同一个位置,并被指定一个共有坐标值(换句话说,将它们定位于同一点)。该工具还会在要素折点位于边的 x,y 容差范围内以及线段相交的位置处添加折点。
整合可执行以下处理任务:
- 位于彼此 x,y 容差内的折点将被分配相同的坐标位置。
- 如果一个要素的折点位于任何其他要素的边的 x,y 容差范围内,则将在边上插入新折点。
- 如果线段相交,则将在相交中涉及的每个要素的相交点处插入一个折点。
存在用于矢量数据集成的备用工具。有关详细信息,请参阅成对整合文档。
插图
使用方法
如果选中了输入要素,则仅会针对那些所选要素执行该工具。
该工具执行的任务与拓扑相同,因为该工具将在 x,y 容差范围内移动要素并在要素相交的位置插入折点。考虑使用拓扑来执行此类操作的原因是:对于拓扑,您可以指定建立要素间关联的规则和条件。
在以下情况中可以选择使用整合而非拓扑:
- 不需要指定要素的移动规则,只需在指定的容差范围内合并所有要素。
- 要在各条线的所有相交处都添加折点。
- 处理的是非地理数据库要素(如 shapefile)或者不同地理数据库中的要素(拓扑中的要素必须全属于同一要素数据集)。
整合期间,可以解决数据中存在的许多潜在问题。其中包括极小的过失或未及的处理、重复线段的自动分离删除以及沿边界线的坐标稀疏化。
建议您不要使用 XY 容差参数。如果未指定该参数,则工具将检查输入要素类空间参考以确定整合期间要使用的 x,y 容差。输入数据空间参考应设置为其默认 x,y 分辨率和 x,y 容差。有关空间参考的详细信息,请参阅空间参考的属性。
XY 容差参数不适用于概化几何形状;而适用于在正确设置的输入要素类空间参考上下文内整合线条和边界。如果将 XY 容差参数设置为与输入空间参考的默认值不符,则可能导致要素移动过多或过少,从而导致几何问题。如果使用了正确的空间参考属性,则运行整合工具可最大限度地减少在后续拓扑操作(例如叠加和融合)期间的数据移动量。
XY 容差的值至关重要。建议将输入要素类空间参考属性设置为其默认值,并允许整合默认使用输入要素类属性。有关聚类处理的详细信息,请参阅聚类处理。
整合工具仅接受将简单要素类作为输入(点、多点、线或面)。
要撤销对输入要素做出的更改,请在编辑会话中使用整合工具。
处理各要素的折点数较多的数据集时(例如,单个要素中包含成千上万甚至上百万个折点),一些几何处理操作可能会导致内存不足。有关详细信息,请参阅对大型数据集进行地理处理。
该工具的输出数据元素属于一种派生的多值输出。要将该工具的输出用于其他工具,请直接使用该工具的输入并将该工具的输出设置为其他工具的前提条件。
警告:
此工具会修改输入数据。有关详细信息以及避免数据被意外更改的策略,请参阅修改或更新输入数据的工具。
语法
arcpy.management.Integrate(in_features, {cluster_tolerance})
参数 | 说明 | 数据类型 |
in_features [[Feature Layer, Long],...] | 要整合的要素类。如果要素间的距离小于容差,则折点或点将被聚类(移动至重合状态)。等级较低的要素类或图层将捕捉到等级较高的要素类或图层中的要素(其中 1 级高于 2 级)。如果使用的 x,y 容差较大,则等级为 1 的要素类中的要素甚至也可能发生移动。有关详细信息,请参阅优先级等级和地理处理工具。 | Value Table |
cluster_tolerance (可选) | 该距离可确定一个范围,要素折点将在此范围内实现重合。要最大限度的减少不必要的折点移动,x,y 容差应该非常小。如果未指定任何值,则将使用输入列表中第一个数据集的 xy 容差。 警告:更改此参数的值可能会导致出现故障或意外结果。建议不要修改此参数。已将其从工具对话框的视图中移除。默认情况下,将使用输入要素类的空间参考 x,y 容差属性。 | Linear Unit |
派生输出
名称 | 说明 | 数据类型 |
out_features | 更新后的输入要素。 | 要素图层 |
代码示例
以下 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")
以下独立脚本演示了如何在脚本环境中应用 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"
# Execute CopyFeatures (since Integrate modifies the original data,
# this ensures the original is preserved)
arcpy.CopyFeatures_management(inFeatures, integrateFeatures)
# Execute Integrate
arcpy.Integrate_management(integrateFeatures)
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是