描述
计算输入要素和标识要素的几何交集。与标识要素重叠的输入要素或输入要素的一部分将获得这些标识要素的属性。
插图
使用
输入要素可以是点、多点、线或面。注记要素、尺寸要素或网络要素不能作为输入。
标识要素必须是面要素,或与输入要素的几何类型相同。
如果使用此工具时,将点作为输入而将面作为标识要素,那么直接落在面边界上的点将被添加到输出中两次;为每个包含该边界的面各添加一次。在此情况下,对输出运行相交工具可识别重复点,以确定要保留的点。
如果输入要素为线而标识要素为面,并且选中了保留关系参数(将 Python 中的 relationship 设置为 KEEP_RELATIONSHIPS),则输出线要素类将具有两个附加字段 LEFT_poly 和 RIGHT_poly。这些字段用于记录线要素左侧和右侧的标识要素的要素 ID。
输入要素类的属性值将被复制到输出要素类。但是,如果输入是一个或多个通过创建要素图层工具创建的图层并且选中了字段的使用比率策略设置项,那么计算输出属性值时将按输入属性值的一定比例进行计算。如果启用了使用比率策略选项,执行叠加操作时,对于任一要素的分割都将按照输入要素属性值的一定比率来生成输出要素的属性值。输出值将根据输入要素几何被分割的比率得出。例如,如果输入几何被分割成相等的两部分,则每个新要素的属性值都等于输入要素属性值的一半。使用比率策略仅适用于数值字段类型。
此工具通过切片的方式处理庞大的数据集以便提高性能和可扩展性。有关详细信息,请参阅对大型数据集进行地理处理。
即使所有输入要素均属于单部件要素,此工具仍能在输出中生成多部件要素。如果不希望生成多部件要素,请对输出要素类使用多部件至单部件工具。
语法
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 (可选) | 确定哪些属性将传递到输出要素类中。
| String |
cluster_tolerance (可选) | 所有要素坐标(节点和折点)之间的最小距离以及坐标可以沿 X 和/或 Y 方向移动的距离。 | Linear unit |
relationship (可选) | 确定是否要将 in_features 和 identity_features 之间的附加空间关系写入到输出。仅当 in_features 为线而 identity_features 为面时适用。
| Boolean |
代码示例
标识 (Identity) 示例 1(Python 窗口)
以下 Python 窗口演示了如何在即时模式下使用标识 (Identity) 函数。
import arcpy
from arcpy import env
env.workspace = "c:/data/data.gdb"
arcpy.Identity_analysis("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
from arcpy import env
# Set the workspace
env.workspace = "C:/data/data.gdb"
# Set local parameters
inFeatures = "wells"
idFeatures = "counties"
outFeatures = "wells_w_county_info"
# Process: Use the Identity function
arcpy.Identity_analysis (inFeatures, idFeatures, outFeatures)
环境
许可信息
- Basic: 否
- Standard: 否
- Advanced: 是