成对相交 (分析)

摘要

计算输入要素的成对交集。 输入要素图层或要素类中相叠置的要素或要素的各部分将被写入到输出要素类。 成对交集是指从第一个输入中选择一个要素,然后将其与所重叠的第二个输入中的要素相交。

备用工具可用于相交操作。 有关详细信息,请参阅相交工具文档。

成对相交工具与相交工具的相似之处在于二者均计算几何交集,但其不同之处在于,“成对相交”工具根据要素对而非所有要素组合来计算交集。

了解有关“成对相交”工作原理的详细信息

插图

“成对相交”工具图示

使用情况

  • 仅支持两种输入要素类。

  • 输入必须为简单要素,例如点、多点、线或面要素。 无法使用诸如注记要素、尺寸注记要素或网络要素等复杂要素。

  • 如果输入具有不同的几何类型,则输出几何类型将默认为最低维度的输入。

    • 如果输入为点要素,则默认输出将为点要素。
    • 如果输入为线要素,并且不存在任何带有点要素的输入,则默认输出将为线要素。
    • 如果所有输入均为面要素,则默认输出将为面要素。

  • 输出类型参数值可以是具有最低维度几何或较低维度几何的输入要素参数值的值。 例如,如果所有输入都是面,则输出可以是面、线或点。 如果某个输入类型为线但不包含点,则输出可以是线或点。 如果任意一个输入是点,则输出类型值只能是点。

  • 相交工具不同,等级不受支持。

  • 默认情况下,来自输入的曲线要素将在输出中进行增密。 要支持输出中的曲线,请使用保留曲线段环境。

  • 所有输入都必须具有空间索引。 可以使用添加空间索引工具创建索引(专门针对 shapefile),或者重新构建现有索引(如果存在任何不正确的可能性)。

  • 当输入要素具有 m- 值或 z- 值时,则只有第一个要素类的 m- 值和 z- 值将会传递到输出要素。 如果第一个要素类不包含 m- 值或 z- 值,则输出将不含 m 值或 z 值。

  • 输出要素类的空间参考将为输入要素参数中第一个要素类的空间参考。 有关详细信息,请参阅空间参考和地理处理

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

参数

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

要相交的输入要素类或图层。 仅允许两个输入。

Value Table
输出要素类

输出要素类。

Feature Class
连接属性
(可选)

指定将输入要素的哪些属性传递到输出要素类。

  • 所有属性输入要素的所有属性都将传递到输出要素类。 这是默认设置。
  • 除要素 ID 外的所有属性除 FID 外,将输入要素的其余所有属性都传递到输出要素类。
  • 仅要素 ID仅输入要素的 FID 字段将传递到输出要素类。
String
XY 容差
(可选)

所有要素坐标(节点和折点)之间的最小距离以及坐标可以沿 x 和/或 y 方向移动的距离。

警告:

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

Linear Unit
输出类型
(可选)

指定将返回的相交类型。

  • 与输入相同所返回的相交要素的几何类型与具有最低维度几何的输入要素的几何类型相同。 如果所有输入都是面,则输出要素类将包含面。 如果一个或多个输入是线但不包含点,则输出是线。 如果一个或多个输入是点,则输出要素类将包含点。 这是默认设置。
  • 线返回的交集为线。 这仅在输入都不是点时才有效。
  • 返回的交集为点。 如果输入是线或面,则输出将是多点要素类。
String

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

要相交的输入要素类或图层。 仅允许两个输入。

Value Table
out_feature_class

输出要素类。

Feature Class
join_attributes
(可选)

指定将输入要素的哪些属性传递到输出要素类。

  • ALL输入要素的所有属性都将传递到输出要素类。 这是默认设置。
  • NO_FID除 FID 外,将输入要素的其余所有属性都传递到输出要素类。
  • ONLY_FID仅输入要素的 FID 字段将传递到输出要素类。
String
cluster_tolerance
(可选)

所有要素坐标(节点和折点)之间的最小距离以及坐标可以沿 x 和/或 y 方向移动的距离。

警告:

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

Linear Unit
output_type
(可选)

指定将返回的相交类型。

  • INPUT所返回的相交要素的几何类型与具有最低维度几何的输入要素的几何类型相同。 如果所有输入都是面,则输出要素类将包含面。 如果一个或多个输入是线但不包含点,则输出是线。 如果一个或多个输入是点,则输出要素类将包含点。 这是默认设置。
  • LINE返回的交集为线。 这仅在输入都不是点时才有效。
  • POINT返回的交集为点。 如果输入是线或面,则输出将是多点要素类。
String

代码示例

PairwiseIntersect 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
arcpy.analysis.PairwiseIntersect(["vegetation_stands", "road_buffer200m", "water_buffer100"], 
                                 "mysites", "ALL")
PairwiseIntersect 示例 2(独立脚本)

查找河流正在穿过的植被类型。

# Name: StreamsInVegetationIntersect.py
# Purpose: Determine the vegetation type streams are traveling through.

# Import system modules
import arcpy

# Set the workspace (to avoid having to type in the full path to the data every time)
arcpy.env.workspace = "c:/data/data.gdb"    

# Process: Find all streams in each vegetation type
inFeatures = ["vegetation", "streams"]
intersectOutput = "streams_in_vegtype"

arcpy.analysis.PairwiseIntersect(inFeatures, intersectOutput)

许可信息

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

相关主题