标识 (分析)
摘要
计算输入要素和标识要素的几何交集。叠置标识要素的输入要素或其各个部分将获得这些标识要素的属性。
插图
用法
-
输入要素可以是点、多点、线或面。不能将注记要素、尺寸要素或网络要素作为输入。
-
标识要素必须是面要素,或与输入要素的几何类型相同。
-
如果使用此工具时,将点作为输入而将面作为标识要素,则直接落在面边界上的点将被添加到输出中两次;为每个属于该边界的面各添加一次。在此情况下,对输出运行相交工具可识别重复点,以确定要保留的点。
-
将保留关系参数选择或设置为 KEEP_RELATIONSHIPS,可将输入要素与标识要素之间的附加空间关系写入输出要素类。如果输入为线而标识要素为面,则将存在两个附加字段:LEFT_poly 和 RIGHT_poly。这些新字段将包含每个输入线要素右侧或左侧的面标识要素的 FID。
-
输入要素类的属性值将被复制到输出要素类。但是,如果输入图层是通过创建要素图层工具创建的并且选中了字段的“使用比率策略”选项,则将计算输出属性值与输入属性值的比率。如果启用了“使用比率策略”选项,分割叠加操作中的要素时,将按输入要素属性值的一定比例生成要素的属性值。输出值将根据输入要素几何被分割的比率得出。例如,如果输入几何被分割成相等的两部分,则每个新要素的属性值都等于输入要素属性值的一半。“使用比率策略”仅适用于数值字段类型。
警告:地理处理工具不支持地理数据库要素类或表字段分割策略。
-
此工具通过切片的方式处理庞大的数据集以便提高性能和可扩展性。有关详细信息,请参阅对大型数据集进行地理处理。
-
即使所有输入要素均属于单部分要素,此工具仍能在输出中生成多部分 (multipart) 要素。如果不希望生成多部分要素,可对输出要素类使用多部分 (Multipart) 至单部分 (Singlepart) 工具。
语法
参数 | 说明 | 数据类型 |
in_features |
输入要素类或图层。 | Feature Layer |
identity_features |
标识要素类或图层。必须是面或与输入要素具有相同的几何类型。 | Feature Layer |
out_feature_class |
该要素类将被创建,并且结果将写入其中。 | Feature Class |
join_attributes (可选) |
确定哪些属性要传递到输出要素类。
| String |
cluster_tolerance (可选) |
所有要素坐标(结点和折点)之间的最小距离以及坐标可以沿 X 和/或 Y 方向移动的距离。 | Linear unit |
relationship (可选) |
选择是否要将输入要素和标识要素之间的附加空间关系写入到输出。仅当输入要素为线而标识要素为面时,此选项才适用。
| Boolean |
代码示例
以下 Python 窗口演示了如何在立即模式下使用 Identity 函数。
import arcpy from arcpy import env env.workspace = "c:/data/data.gdb" arcpy.Identity_analysis("wells", "counties", "wells_w_county_info")
以下独立脚本是如何在脚本环境中应用 Identity 函数的简单示例。
# IdentityWells.py # Description: Simple example showing use of Identity tool # Author: ESRI # 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)