成对整合 (分析)

描述

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

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

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

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

插图

使用方法

警告：

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

• 如果选中了输入要素，则仅会针对那些所选要素执行该工具。

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

  在以下情况中可以选择使用成对整合而非拓扑：

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

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

• 建议您不要使用 XY 容差参数。如果未指定该参数，则工具将检查输入要素类空间参考以确定整合期间要使用的 x,y 容差。输入数据空间参考应设置为其默认 x,y 分辨率和 x,y 容差。有关空间参考的详细信息，请参阅空间参考的属性。

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

  XY 容差参数的值至关重要。建议将输入要素类空间参考属性设置为其默认值，并允许成对整合默认使用输入要素类属性。有关聚类处理的详细信息，请参阅聚类处理。

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

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

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

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

• 此工具支持并行处理因子环境。如果环境未设置（默认情况下）或设置为 100，则将启用完全并行处理，同时该工具尝试将工作分配给计算机上的所有逻辑内核。将环境设置为 0 将禁用并行处理。在 1 到 99 之间指定一个因子时，工具将通过应用公式（并行处理因子 / 100 * 逻辑内核数）确定要使用的逻辑内核的百分比，其结果将向上舍入到最近的整数值。如果此公式的结果是 0 或 1，则将不启用并行处理。

语法

arcpy.analysis.PairwiseIntegrate(in_features, {cluster_tolerance})

参数	说明	数据类型
in_features [in_features,...]	要整合的要素类。如果要素间的距离小于容差，则折点或点将被聚类（移动至重合状态）。	Value Table
cluster_tolerance （可选）	该距离可确定一个范围，要素折点将在此范围内实现重合。要最大限度的减少不必要的折点移动，x,y 容差应该非常小。如果未指定任何值，则将使用输入列表中第一个数据集的 xy 容差。 警告： 更改此参数的值可能会导致出现故障或意外结果。建议不要修改此参数。已将其从工具对话框的视图中移除。默认情况下，将使用输入要素类的空间参考 x,y 容差属性。	Linear Unit

派生输出

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

代码示例

PairwiseIntegrate 示例 1（Python 窗口）

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CopyFeatures_management("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.PairwiseIntegrate_analysis("C:/output/output.gdb/vegtype")

PairwiseIntegrate 示例 2（独立脚本）

以下独立脚本演示了如何在脚本环境中应用 PairwiseIntegrate 函数。

# 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.PairwiseIntegrate_analysis(integrateFeatures)

环境

当前工作空间, 范围, XY 容差, 并行处理因子

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是