标识 (分析)

摘要

计算输入要素和标识要素的几何交集。 输入要素或其与标识要素重叠的部分将获得这些标识要素的属性。

插图

标识工具图示

使用情况

  • 输入要素参数值可以是点、多点、线或面。 输入不能是注记要素、尺寸要素或网络要素。

  • 标识要素参数值必须是面,或与输入要素参数值的几何类型相同。

  • 如果使用此工具时,将点作为输入而将面作为标识要素值,那么直接落在面边界上的点将被添加到输出中两次;为每个包含该边界的面各添加一次。 在此情况下,对输出运行相交工具可识别重复点,以确定要保留的点。

  • 输入要素参数值的几何为线而标识要素参数值的几何为面,并且选中了保留关系参数,则输出线要素类将具有两个附加字段 LEFT_polyRIGHT_poly。 这些字段用于记录线要素左侧和右侧的标识要素参数值的要素 ID。

  • 输入要素类的属性值将被复制到输出要素类。 但是,如果输入是一个或多个通过创建要素图层工具创建的图层并且选中了字段的使用比率策略设置项,那么计算输出属性值时将按输入属性值的一定比例进行计算。 如果启用了使用比率策略选项,执行叠加操作时,对于任一要素的分割都将按照输入要素属性值的一定比率来生成输出要素的属性值。 输出值将根据输入要素几何被分割的比率得出。 例如,如果输入几何被分割成相等的两部分,则每个新要素的属性值都等于输入要素属性值的一半。 使用比率策略仅适用于数值字段类型。

    警告:

    地理处理工具不支持地理数据库要素类或表字段分割策略

  • 为了获得更好的性能和可扩展性,此工具将使用切片过程来处理非常大的数据集。 有关详细信息,请参阅大型数据集的切片处理

  • 即使所有输入要素均属于单部件要素,此工具仍可能在输出中生成多部件要素。 如果不希望生成多部件要素,请对输出要素类使用多部件至单部件工具。

参数

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

输入要素类或图层。

Feature Layer
标识要素

标识要素类或图层。 必须是面或具有与输入要素相同的几何类型。

Feature Layer
输出要素类

将要创建并在其中写入结果的要素类。

Feature Class
要连接的属性
(可选)

指定如何将属性传递到输出要素类。

  • 所有属性输入要素与标识要素的所有属性(包括 FID)都将传递到输出要素。 如果未找到任何交集,则标识要素值不会传递到输出(其值将设置为空字符串或 0)并且标识要素 FID 将为 -1。 这是默认设置。
  • 除要素 ID 外的所有属性输入要素和标识要素中,除 FID 以外的所有属性都将传递到输出要素。 如果未找到任何交集,则标识要素值不会传递到输出(其值将设置为空字符串或 0)。
  • 仅要素 ID输入要素的所有属性和标识要素的 FID 属性将传递到输出要素。 如果未找到交集,则输出中标识要素的 FID 属性值将为 -1。
String
XY 容差
(可选)

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

警告:

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

Linear Unit
保留关系
(可选)

指定是否将输入要素标识要素参数值之间的附加空间关系写入输出。 这仅适用于输入要素参数值的几何类型为线且标识要素参数值的几何类型为面时。

  • 未选中 - 不会将附加空间关系写入输出。
  • 选中 - 输出线要素会包含两个附加字段,LEFT_polyRIGHT_poly。 这些字段用于记录线要素左侧和右侧的标识要素参数值的要素 ID。
Boolean

arcpy.analysis.Identity(in_features, identity_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {relationship})
名称说明数据类型
in_features

输入要素类或图层。

Feature Layer
identity_features

标识要素类或图层。 必须是面或具有与输入要素相同的几何类型。

Feature Layer
out_feature_class

将要创建并在其中写入结果的要素类。

Feature Class
join_attributes
(可选)

指定如何将属性传递到输出要素类。

  • ALL输入要素与标识要素的所有属性(包括 FID)都将传递到输出要素。 如果未找到任何交集,则标识要素值不会传递到输出(其值将设置为空字符串或 0)并且标识要素 FID 将为 -1。 这是默认设置。
  • NO_FID输入要素和标识要素中,除 FID 以外的所有属性都将传递到输出要素。 如果未找到任何交集,则标识要素值不会传递到输出(其值将设置为空字符串或 0)。
  • ONLY_FID输入要素的所有属性和标识要素的 FID 属性将传递到输出要素。 如果未找到交集,则输出中标识要素的 FID 属性值将为 -1。
String
cluster_tolerance
(可选)

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

警告:

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

Linear Unit
relationship
(可选)

指定是否将 in_featuresidentity_features 参数值之间的附加空间关系写入输出。 这仅适用于 in_features 参数值的几何类型为线且 identity_features 参数值的几何类型为面时。

  • NO_RELATIONSHIPS不会将附加空间关系写入输出。
  • KEEP_RELATIONSHIPS输出线要素会包含两个附加字段,LEFT_polyRIGHT_poly。 这些字段包含线要素左侧和右侧的 identity_features 参数值的要素 ID。
Boolean

代码示例

Identity 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = "c:/data/data.gdb"
arcpy.analysis.Identity("wells", "counties", "wells_w_county_info")
Identity 示例 2(独立 Python 脚本)

以下独立 Python 脚本是如何在脚本环境中应用 Identity 函数的简单示例。

# IdentityWells.py
# Description: Simple example showing use of Identity tool
 
# Import system modules
import arcpy

# Set the workspace
arcpy.env.workspace = "C:/data/data.gdb"

# Set local parameters
inFeatures = "wells"
idFeatures = "counties"
outFeatures = "wells_w_county_info"

# Process: Use the Identity function
arcpy.analysis.Identity(inFeatures, idFeatures, outFeatures)

环境

特殊情况

并行处理因子

此工具支持并行处理因子环境。 如果未设置环境(默认)或设置为 0,则将禁用并行处理;不会使用并行处理,而是按顺序进行处理。 如将环境设置为 100,则将启用并行处理;将使用并行处理,并且将进行并行处理。 启用并行处理时,最多将使用 10 个内核。

目前,面-面、线-面以及点-面叠加操作支持并行处理。

许可信息

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

相关主题