3D 联合 (3D Analyst)
摘要
基于输入要素类对闭合的重叠多面体要素进行合并。
插图
用法
-
此分析需要闭合的多面体几何图形。是否为闭合 3D 工具可用于确定多面体要素类是否包含闭合要素，封闭多面体工具可用于消除多面体要素中的空隙。
通过使构成要素壳的三角形和环相交并移除多余的内部部分，可将包含重叠体积的多面体要素合并。该过程反复执行，直到处理完要素类中的所有多面体要素。
分组字段可用于标识将要联合的要素，例如，在多面体表示某一城市中的建筑部分时，其中多个要素表示一个建筑。这可以减少工具必须遍历数据集的次数，因而性能得到显著提升。不会将要素与所有要素进行比较，而是仅与参与到组中的要素进行比较。
在启用了优化后，该工具会尝试通过分析每个要素的边界框来将要素自动细分成各个组。如果已指定分组字段，那么禁用优化可以增强工具的性能。如果所需输出是要将所有重叠要素合并为一个多面体，则在没有分组字段的情况下也可以将优化禁用。
-
确定要聚合到一起的要素的个数时应十分谨慎，因为可能会在输出要素类中创建超大型复杂要素，这会影响显示性能。
如果两个或多个多面体要素仅共享一条边或一个折点，则会发出一个警告，说明生成的要素不是简单要素，因此无法创建。如果组中包含的多面体没有共享的体积或空间，则会返回相同的消息。
-
可以创建一个可选表来标识为创建每个联合输出所联合的源要素的属性。
注:可在表和输出要素类之间建立关系，以查询与源要素相关联的属性。有关详细信息，请参阅将一个表中的属性关联到另一个表。
此工具是提供针对 3D 要素的分析函数的 3D 集合运算符。有关什么是集合运算符以及如何使用它们的详细信息，请参阅使用 3D 集合运算符。
语法
| 参数 | 说明 | 数据类型 |
in_feature_class |
要相交和聚合的闭合多面体要素。 | Feature Layer |
group_field (可选) |
用于标识应归到一组的要素的字段。 | Field |
out_feature_class |
将存储聚合要素的输出多面体要素类。 | Feature Class |
out_table (可选) |
表示输入要素与其对应的聚合要素关系的多对一表。 | Table |
disable_optimization (可选) |
指定优化自动发生还是禁用：
| Boolean |
output_all (可选) |
确定输出要素类是包含所有要素还是仅包含已联合的重叠要素。
| Boolean |
代码实例
下面的示例演示了如何在 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')
下面的示例演示了如何在独立 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)