3D 联合 (3D Analyst)

许可等级:BasicStandardAdvanced

摘要

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

插图

Union 3D

用法

语法

Union3D_3d (in_feature_class, {group_field}, out_feature_class, {out_table}, {disable_optimization}, {output_all})
参数说明数据类型
in_feature_class

要相交和聚合的闭合多面体要素。

Feature Layer
group_field
(可选)

用于标识应归到一组的要素的字段。

Field
out_feature_class

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

Feature Class
out_table
(可选)

表示输入要素与其对应的聚合要素关系的多对一表。

Table
disable_optimization
(可选)

指定优化自动发生还是禁用:

  • ENABLED对输入数据执行优化。该工具将进行一些预处理来检测可能重叠的要素,将其组合在一起以提高性能,并为每组重叠要素创建唯一的输出。这是默认设置。
  • DISABLED不对输入数据执行优化。将根据要素的分组字段将要素联合起来,或将所有要素都联合到一个输出要素中。
Boolean
output_all
(可选)

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

  • DISABLED仅将已联合的要素写到输出中。
  • ENABLED将所有输入要素写到输出中。这是默认设置。
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)

环境

相关主题

许可信息

ArcGIS for Desktop Basic: 需要 3D Analyst
ArcGIS for Desktop Standard: 需要 3D Analyst
ArcGIS for Desktop Advanced: 需要 3D Analyst
5/10/2014