3D 内部 (3D Analyst)

摘要

该工具通过对每个要素进行判定来确定它是否落在多面体 (multipatch) 的内部。如果它落在多面体要素内，那么它会向新生成的表文件中写入一个条目，指明它所落入的要素。

了解有关“3D 内部”工作原理的详细信息

插图

用法

• 需要输入要素，且输入要素中必须含有闭合的多面体几何。

• 只有闭合多面体才能用于分析过程。

• 一个要素可能落入多个闭合多面体要素内，从而在输出表中对应多个条目。

• “3D 内部”是一种 3D 集合运算符，是“3D 要素”工具集的一部分。有关什么是集合运算符以及如何使用它们的详细信息，请参阅使用 3D 集合运算符。

• 输出表中会显示下列字段：

  • OBJECTID：字段的 OBJECTID。
  • Target_ID：原始要素的 OBJECTID。
  • Status：指示输入要素 (Target_ID) 是否完全或部分落入多面体内。

• 如果选择了复杂输出表选项，则输出表中会显示下列字段：

  • OBJECTID：字段的 OBJECTID。
  • Target_ID：原始要素的 OBJECTID。
  • Status：指示输入要素 (Target_ID) 是否完全或部分落入多面体内。
  • Container_ID：Container_ID 指明输入要素完全或部分落入在哪个多面体内。

语法

Inside3D_3d (in_target_feature_class, in_container_feature_class, out_table, {complex_output})

参数	说明	数据类型
in_target_feature_class	启用了 z 值的点、线、面或多面体要素。	Feature Layer
in_container_feature_class	多面体要素。多面体必须闭合。执行此工具之前，请使用“是否为闭合 3D”工具判断多面体是否闭合。	Feature Layer
out_table	输出表，它提供全部或部分位于闭合输入多面体(Multipatch)要素内部的 3D 输入要素的列表。输出表包含 OBJECTID（对象 ID）、Target_ID 和 Status 字段。Status 将指明输入要素 (Target_ID) 是否完全或部分落入多面体内。	Table
complex_output （可选）	复杂输出表选项可对输出表进行修改，从而将有关输入要素和输入多面体(Multipatch)要素之间关系的信息包含进来。这样就可以判断出全部或部分落入特定闭合多面体中的要素。如果选中该选项，那么在输出表中将额外显示一个 Container_ID 和 Target_ID 的信息。此 Container_ID 指明输入要素 (Target_ID) 完全或部分落入在哪个多面体内。	Boolean

代码示例

“3D 内部”示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 3D 内部函数。

import arcpy
from arcpy import env

arcpy.CheckOutExtension('3D')
env.workspace = 'C:/data'
arcpy.Inside3D_3d('inFeature.shp', 'sample.gdb/multipatch', 'sample.gdb/output_table')

“3D 内部”示例 2（独立脚本）

以下 Python 脚本演示了如何在独立脚本中使用 3D 内部函数。

'''****************************************************************************
Name: Inside3D Example
Description: This script demonstrates how to use the
             Inside3D tool.
****************************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env

try:
    # Obtain a license for the ArcGIS 3D Analyst extension
    arcpy.CheckOutExtension('3D')
    # Set environment settings
    env.workspace = 'C:/data'
    # Set Local Variables
    inFC = 'Points_3D.shp' # the input feature
    inMP = 'Buildings.shp' # the input multi-patch
    # Ensure output has a unique name
    outTbl = arcpy.CreateUniqueName('Output_Table.dbf')
    
    # Execute Inside 3D
    arcpy.Inside3D_3d(inFC, inMP, outTbl)

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)

环境

输出配置关键字, 自动提交, 范围

许可信息

ArcView: 需要 3D Analyst

ArcEditor: 需要 3D Analyst

ArcInfo: 需要 3D Analyst