3D 联合 (3D Analyst)

摘要

基于输入要素类对闭合的重叠多面体要素进行合并。

插图

“3D 联合”工具图示

使用情况

  • 此分析需要闭合的多面体几何图形。 是否为闭合 3D 工具可用于确定多面体要素类是否包含闭合要素,封闭多面体工具可用于消除多面体要素中的空隙。

  • 该工具通过保留输入要素的最外层部分并移除位于已组合要素内部范围内的几何,来组合包含重叠体积的相交多面体要素。 可以创建一个单独的表来标识已合并在一起以创建每个组合输出的源要素。

  • 分组字段可用于标识要联合的要素,例如当多个要素表示同一建筑物部分时。 这可以减少工具必须遍历数据集的次数,因而性能得到显著提升。 不会将要素与所有要素进行比较,而是仅与参与到组中的要素进行比较。

  • 在启用了优化后,该工具会尝试通过分析每个要素的边界框来将要素自动细分成各个组。 如果已指定分组字段,那么禁用优化可以增强工具的性能。 如果所需输出是要将所有重叠要素合并为一个多面体,则在没有分组字段的情况下也可以将优化禁用。 确定要聚合到一起的要素的个数时应十分谨慎,因为可能会在输出要素类中创建超大型复杂要素,这会影响显示性能。

  • 如果两个或多个多面体要素仅共享一条边或一个折点,则会发出一个警告,说明生成的要素不是简单要素,因此无法创建。 此消息指示这些要素未合并,因为其未共享空间卷。

  • 输入多面体要素的纹理和颜色将不会在输出中保留。

参数

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

要联合的多面体要素。

Feature Layer
输出要素类

将存储聚合要素的输出多面体要素类。

Feature Class
分组字段
(可选)

将用于标识要分组在一起的要素的字段。

Field
禁用优化
(可选)

指定是否将对输入数据执行优化。 优化操作将会预处理输入数据,方法是对其进行分组以提高性能并针对每个重叠要素集创建唯一输出。

  • 未选中 - 将对输入数据执行优化。 将忽略分组字段。 这是默认设置。
  • 选中 - 将不会对输入数据执行优化。 要素会存储在单个输出要素中,或者根据其分组字段(如果提供)进行联合。
Boolean
输出所有实体
(可选)

指定输出要素类是将包含所有要素,还是仅包含已联合的重叠要素。

  • 选中 - 将所有输入要素写入输出。 这是默认设置。
  • 未选中 - 仅将已联合的要素写入输出。 将忽略不重叠的要素。
Boolean
输出表
(可选)

用于标识影响每个输出的输入要素的多对一表。

Table

arcpy.ddd.Union3D(in_feature_class, out_feature_class, {group_field}, {disable_optimization}, {output_all}, {out_table})
名称说明数据类型
in_feature_class

要联合的多面体要素。

Feature Layer
out_feature_class

将存储聚合要素的输出多面体要素类。

Feature Class
group_field
(可选)

将用于标识要分组在一起的要素的字段。

Field
disable_optimization
(可选)

指定是否将对输入数据执行优化。 优化操作将会预处理输入数据,方法是对其进行分组以提高性能并针对每个重叠要素集创建唯一输出。

  • ENABLE将对输入数据执行优化。 将忽略分组字段。 这是默认设置。
  • DISABLE将不会对输入数据执行优化。 要素会存储在单个输出要素中,或者根据其分组字段(如果提供)进行联合。
Boolean
output_all
(可选)

指定输出要素类是将包含所有要素,还是仅包含已联合的重叠要素。

  • ENABLE将所有输入要素写入输出。 这是默认设置。
  • DISABLE仅将已联合的要素写入输出。 将忽略不重叠的要素。
Boolean
out_table
(可选)

用于标识影响每个输出的输入要素的多对一表。

Table

代码示例

Union3D 示例 1(Python 窗口)

下面的示例演示了如何在 Python 窗口中使用此工具。

import arcpy
from arcpy import env

env.workspace = 'C:/data'
arcpy.Union3D_3d('multipatch.shp', 'union_output.shp', 'GROUP_FIELD', 
                'DISABLE', 'ENABLE', 'UnionTable.dbf')
Union3D 示例 2(独立脚本)

下面的示例演示了如何在独立 Python 脚本中使用此工具。

'''****************************************************************************
Name: Union3D Example
Description: This script demonstrates how to use the 
             Union3D tool.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data'

# Set Local Variables
inMP = "multipatch.shp"

# Ensure output multipatch has a unique name
outMP = arcpy.CreateUniqueName("union_output.shp")
outTbl = arcpy.CreateUniqueName("UnionTable.dbf")
GroupField = "Type"
optimize = "DISABLE"
solids = "ENABLE"

# Execute Union3D
arcpy.ddd.Union3D(inMP, outMP, GroupField, optimize, solids, outTbl)

相关主题