标注 | 说明 | 数据类型 |
输入多面体要素 | 要联合的多面体要素。 | Feature Layer |
输出要素类 | 将存储聚合要素的输出多面体要素类。 | Feature Class |
分组字段 (可选) | 将用于标识要分组在一起的要素的字段。 | Field |
禁用优化 (可选) | 指定是否将对输入数据执行优化。 优化操作将会预处理输入数据,方法是对其进行分组以提高性能并针对每个重叠要素集创建唯一输出。
| Boolean |
输出所有实体 (可选) | 指定输出要素类是将包含所有要素,还是仅包含已联合的重叠要素。
| Boolean |
输出表 (可选) | 用于标识影响每个输出的输入要素的多对一表。 | Table |
摘要
基于输入要素类对闭合的重叠多面体要素进行合并。
插图
使用情况
此分析需要闭合的多面体几何图形。 是否为闭合 3D 工具可用于确定多面体要素类是否包含闭合要素,封闭多面体工具可用于消除多面体要素中的空隙。
该工具通过保留输入要素的最外层部分并移除位于已组合要素内部范围内的几何,来组合包含重叠体积的相交多面体要素。 可以创建一个单独的表来标识已合并在一起以创建每个组合输出的源要素。
分组字段可用于标识要联合的要素,例如当多个要素表示同一建筑物部分时。 这可以减少工具必须遍历数据集的次数,因而性能得到显著提升。 不会将要素与所有要素进行比较,而是仅与参与到组中的要素进行比较。
在启用了优化后,该工具会尝试通过分析每个要素的边界框来将要素自动细分成各个组。 如果已指定分组字段,那么禁用优化可以增强工具的性能。 如果所需输出是要将所有重叠要素合并为一个多面体,则在没有分组字段的情况下也可以将优化禁用。 确定要聚合到一起的要素的个数时应十分谨慎,因为可能会在输出要素类中创建超大型复杂要素,这会影响显示性能。
如果两个或多个多面体要素仅共享一条边或一个折点,则会发出一个警告,说明生成的要素不是简单要素,因此无法创建。 此消息指示这些要素未合并,因为其未共享空间卷。
输入多面体要素的纹理和颜色将不会在输出中保留。
参数
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 (可选) |
指定是否将对输入数据执行优化。 优化操作将会预处理输入数据,方法是对其进行分组以提高性能并针对每个重叠要素集创建唯一输出。
| Boolean |
output_all (可选) |
指定输出要素类是将包含所有要素,还是仅包含已联合的重叠要素。
| Boolean |
out_table (可选) | 用于标识影响每个输出的输入要素的多对一表。 | Table |
代码示例
下面的示例演示了如何在 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')
下面的示例演示了如何在独立 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)
许可信息
- Basic: 需要 3D Analyst
- Standard: 需要 3D Analyst
- Advanced: 需要 3D Analyst