摘要
基于输入要素类对闭合的重叠多面体要素进行合并。
插图
用法
-
此分析需要闭合的多面体几何图形。是否为闭合 3D 工具可用于确定多面体要素类是否包含闭合要素，封闭多面体工具可用于消除多面体要素中的空隙。
通过使要素壳相交并移除多余的内部部分，可将包含重叠体积的多面体要素合并。该过程反复执行，直到处理完要素类中的所有多面体要素。
分组字段可用于标识将要联合的要素，例如，在多面体表示某一城市中的建筑部分时，其中多个要素表示一个建筑。这可以减少工具必须遍历数据集的次数，因而性能得到显著提升。不会将要素与所有要素进行比较，而是仅与参与到组中的要素进行比较。
在启用了优化后，该工具会尝试通过分析每个要素的边界框来将要素自动细分成各个组。如果已指定分组字段，那么禁用优化可以增强工具的性能。如果所需输出是要将所有重叠要素合并为一个多面体，则在没有分组字段的情况下也可以将优化禁用。
确定要聚合到一起的要素的个数时应十分谨慎，因为可能会在输出要素类中创建超大型复杂要素，这会影响显示性能。
如果两个或多个多面体要素仅共享一条边或一个折点，则会发出一个警告，说明生成的要素不是简单要素，因此无法创建。如果组中包含的多面体没有共享的体积或空间，则会返回相同的消息。
可以创建一个可选表来标识为创建每个联合输出所联合的源要素的属性。
语法
Union3D_3d (in_feature_class, out_feature_class, {group_field}, {out_table}, {disable_optimization}, {output_all})| 参数 | 说明 | 数据类型 |
in_feature_class | 要联合的多面体要素。 | Feature Layer |
out_feature_class | 将存储聚合要素的输出多面体要素类。 | Feature Class |
group_field (可选) | 用于标识应归到一组的要素的字段。 | Field |
out_table (可选) | 用于标识影响每个输出的输入要素的多对一表。 | Table |
disable_optimization (可选) |
指定是否对输入数据执行优化。优化操作将会预处理输入数据，方法是对它们进行分组以提高性能并针对每个重叠要素集创建唯一输出。
| Boolean |
output_all (可选) |
确定输出要素类是包含所有要素还是仅包含已联合的重叠要素。
| Boolean |
代码实例
Union3D 示例 1（Python 窗口）
下面的示例演示了如何在 Python 窗口中使用此工具。
import arcpy
from arcpy import env
arcpy.CheckOutExtension('3D')
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
import exceptions, sys, traceback
from arcpy import env
try:
arcpy.CheckOutExtension('3D')
# Set environment settings
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)
arcpy.CheckInExtension('3D')
except arcpy.ExecuteError:
print arcpy.GetMessages()
except:
# Get the traceback object
tb = sys.exc_info()[2]
tbinfo = traceback.format_tb(tb)[0]
# Concatenate error information into message string
pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
.format(tbinfo, str(sys.exc_info()[1]))
msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
# Return python error messages for script tool or Python Window
arcpy.AddError(pymsg)
arcpy.AddError(msgs)