联合 (分析)

摘要

计算输入要素的几何并集。所有要素都将被写入到输出要素类,且具有来自与其重叠的输入要素的属性。

了解有关“联合”工具工作原理的详细信息

插图

Union illustration

用法

语法

Union_analysis (in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {gaps})
参数说明数据类型
in_features
[[in_features, {Rank}],...]

输入要素类或图层列表。要素间距小于拓扑容差时,等级较低的要素将捕捉到等级较高的要素。最高等级为一。所有输入要素都必须是面。

Value Table
out_feature_class

将包含结果的要素类。

Feature Class
join_attributes
(可选)

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

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

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

Linear unit
gaps
(可选)

间距是输出要素类中被其他面完全包围的区域。它并非无效,但最好对其进行识别以供分析之用。要在输出中找出间距,请将此选项设置为 NO_GAPS,这样便会在此类区域中创建要素。要选择此类要素,可通过判定输入要素的所有 FID 值是否均等于 -1 来查询输出要素类。

  • GAPS被面完全包围的输出区域不会创建要素。这是默认设置。
  • NO_GAPS被面完全包围的输出区域会创建一个要素。该要素将有空属性。
Boolean

代码示例

Union 示例(Python 窗口)

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

import arcpy from arcpy import env env.workspace = "C:/data/data/gdb" arcpy.Union_analysis (["well_buff50", "stream_buff200", "waterbody_buff500"], "water_buffers", "NO_FID", 0.0003) arcpy.Union_analysis ([["counties", 2],["parcels", 1],["state", 2]], "state_landinfo")
Union 示例 2(独立脚本)

以下独立脚本演示了在脚本中应用 Union 函数的两种方式。

# unions.py # Purpose: union 3 feature classes # Author: ESRI  # Import the system modules import arcpy from arcpy import env   # Set the current workspace  # (to avoid having to specify the full path to the feature classes each time) env.workspace = "c:/data/data.gdb"    # Union 3 feature classes but only carry the FID attributes to the output inFeatures = ["well_buff50", "stream_buff200", "waterbody_buff500"] outFeatures = "water_buffers" clusterTol = 0.0003 arcpy.Union_analysis (inFeatures, outFeatures, "ONLY_FID", clusterTol)  # Union 3 other feature classes, but specify some ranks for each  # since parcels has better spatial accuracy inFeatures = [["counties", 2],["parcels", 1],["state", 2]] outFeatures = "state_landinfo"  arcpy.Union_analysis (inFeatures, outFeatures)

环境

相关主题

许可信息

ArcView: 是
ArcEditor: 是
ArcInfo: 是

7/10/2012