整合 (数据管理)

摘要

分析一个或多个要素类中要素之间的要素折点的坐标位置。 彼此间距离在指定范围内的折点被认为表示同一个位置，并被指定一个共有坐标值（换句话说，将它们定位于同一点）。 该工具还会在要素折点位于边的 x,y 容差范围内以及线段相交的位置处添加折点。

整合可执行以下处理任务：

• 位于彼此 x,y 容差内的折点将被分配相同的坐标位置。
• 如果一个要素的折点位于任何其他要素的边的 x,y 容差范围内，则将在边上插入新折点。
• 如果线段相交，则将在相交中涉及的每个要素的相交点处插入一个折点。

备用工具适用于矢量数据集成。 有关详细信息，请参阅成对整合文档。

插图

使用情况

警告：

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

• 如果已选择输入要素，则此工具将仅在所选要素上运行。

• 该工具执行的任务与拓扑相同，因为该工具将在 x,y 容差范围内移动要素并在要素相交的位置插入折点。 考虑使用拓扑来执行此类操作的原因是：对于拓扑，您可以指定建立要素间关联的规则和条件。

  在以下情况下，请使用此工具，而非拓扑：

  • 不需要指定要素的移动规则，只需在指定的容差范围内合并所有要素。
  • 要在各条线相交的任何地方添加折点。
  • 处理的是非地理数据库要素（如 shapefile）或者不同地理数据库中的要素（拓扑中的要素必须全属于同一要素数据集）。

• 整合期间，可以解决数据中存在的潜在问题。 其中包括极小的过失或未及的处理、重复线段的自动分离删除以及沿边界线的坐标稀疏化。

• 建议您不要为 XY 容差参数提供值。 如果未提供任何值，则该工具将检查输入要素类的空间参考以确定整合期间要使用的 x,y 容差。 确保将输入数据的空间参考设置为其默认 x,y 分辨率和 x,y 容差。

  XY 容差参数不适用于概化几何形状； 而适用于在正确设置的输入要素类空间参考上下文内整合线条和边界。 将 XY 容差参数设置为输入空间参考默认值以外的值可能会导致要素移动过多或过少，由此导致几何问题。 如果使用了正确的空间参考属性，则运行整合工具可最大限度地减少在后续拓扑操作（例如叠加和融合）期间的数据移动量。

  了解有关聚类处理的详细信息

• 此工具仅接受将简单要素类作为输入（点、多点、线或面）。

• 要撤销对输入要素做出的更改，请在编辑会话中使用此工具。

• 处理各要素的折点数较多的数据集时（例如，单个要素中包含成千上万甚至上百万个折点），一些几何处理操作可能会导致内存不足。 有关详细信息，请参阅对大型数据集进行地理处理。

• 该工具的输出数据元素属于一种派生的多值输出。 要将该工具的输出用于其他工具，请直接使用该工具的输入并将该工具的输出设置为其他工具的前提条件。

  了解有关设置前提条件的详细信息

参数

对话框

标注	说明	数据类型
输入要素	将进行整合的要素类。 如果要素间的距离小于容差，则折点或点将被聚类（移动至重合状态）。 等级较低的要素类或图层将捕捉到等级较高的要素类或图层中的要素（其中 1 级高于 2 级）。 如果使用的 x,y 容差较大，则等级为 1 的要素类中的要素甚至也可能发生移动。 有关详细信息，请参阅优先级等级和地理处理工具。	Value Table
XY 容差 (可选)	该距离可确定一个范围，要素折点将在此范围内实现重合。 要最大限度的减少不必要的折点移动，x,y 容差应较小。 如果未提供任何值，则将使用输入列表中第一个数据集的 x,y 容差。 警告： 更改此参数的值可能会导致出现故障或意外结果。 建议不要修改此参数。 已将其从工具对话框的视图中移除。 默认情况下，将使用输入要素类的空间参考 x,y 容差属性。	Linear Unit

派生输出

标注	说明	数据类型
更新后的输入要素	更新后的输入要素。	Feature Layer

Python

arcpy.management.Integrate(in_features, {cluster_tolerance})

名称	说明	数据类型
in_features [[Feature Layer, Long],...]	将进行整合的要素类。 如果要素间的距离小于容差，则折点或点将被聚类（移动至重合状态）。 等级较低的要素类或图层将捕捉到等级较高的要素类或图层中的要素（其中 1 级高于 2 级）。 如果使用的 x,y 容差较大，则等级为 1 的要素类中的要素甚至也可能发生移动。 有关详细信息，请参阅优先级等级和地理处理工具。	Value Table
cluster_tolerance (可选)	该距离可确定一个范围，要素折点将在此范围内实现重合。 要最大限度的减少不必要的折点移动，x,y 容差应较小。 如果未提供任何值，则将使用输入列表中第一个数据集的 x,y 容差。 警告： 更改此参数的值可能会导致出现故障或意外结果。 建议不要修改此参数。 已将其从工具对话框的视图中移除。 默认情况下，将使用输入要素类的空间参考 x,y 容差属性。	Linear Unit

派生输出

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

代码示例

整合示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 Integrate 函数。

import arcpy

arcpy.env.workspace = "C:/data"
arcpy.management.CopyFeatures("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.management.Integrate("C:/output/output.gdb/vegtype")

整合示例 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"
 
# Run CopyFeatures (since Integrate modifies the original data,
#  this ensures the original is preserved)
arcpy.management.CopyFeatures(inFeatures, integrateFeatures)
 
# Run Integrate
arcpy.management.Integrate(integrateFeatures)

环境

当前工作空间, 范围, XY 容差