成对整合 (分析)

摘要

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

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

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

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

插图

“成对整合”工具图示

使用情况

    警告:

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

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

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

    在以下情况下,请使用此工具,而非拓扑:

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

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

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

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

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

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

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

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

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

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

参数

标注说明数据类型
输入要素

将进行整合的要素类。 如果要素间的距离小于容差,则折点或点将被聚类(移动至重合状态)。

Value Table
XY 容差
(可选)

该距离可确定一个范围,要素折点将在此范围内实现重合。 要最大限度的减少不必要的折点移动,x,y 容差应较小。 如果未提供任何值,则将使用输入列表中第一个数据集的 x,y 容差。

警告:

更改此参数的值可能会导致出现故障或意外结果。 建议不要修改此参数。 已将其从工具对话框的视图中移除。 默认情况下,将使用输入要素类的空间参考 x,y 容差属性。

Linear Unit

派生输出

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

更新后的输入要素。

Feature Layer

arcpy.analysis.PairwiseIntegrate(in_features, {cluster_tolerance})
名称说明数据类型
in_features
[in_features,...]

将进行整合的要素类。 如果要素间的距离小于容差,则折点或点将被聚类(移动至重合状态)。

Value Table
cluster_tolerance
(可选)

该距离可确定一个范围,要素折点将在此范围内实现重合。 要最大限度的减少不必要的折点移动,x,y 容差应较小。 如果未提供任何值,则将使用输入列表中第一个数据集的 x,y 容差。

警告:

更改此参数的值可能会导致出现故障或意外结果。 建议不要修改此参数。 已将其从工具对话框的视图中移除。 默认情况下,将使用输入要素类的空间参考 x,y 容差属性。

Linear Unit

派生输出

名称说明数据类型
out_features

更新后的输入要素。

Feature Layer

代码示例

PairwiseIntegrate 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.CopyFeatures("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.analysis.PairwiseIntegrate("C:/output/output.gdb/vegtype")
PairwiseIntegrate 示例 2(独立脚本)

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

# Description: Run PairwiseIntegrate 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 PairwiseIntegrate modifies the original data, this 
# ensures the original is preserved)
arcpy.management.CopyFeatures(inFeatures, integrateFeatures)

# Run PairwiseIntegrate
arcpy.analysis.PairwiseIntegrate(integrateFeatures)