3D 内部 (3D Analyst)

摘要

确定来自输入要素类的 3D 要素是否包含在闭合的多面体中，并写入用于记录要素（部分或全部在多面体中）的输出表。

插图

用法

• 所有输入要素都必须将 Z 信息存储为几何的一部分。如果在 2D 要素类中包含基于字段的高度测量值，则依据属性实现要素转 3D 工具可用于创建 3D 要素类。

• 此分析需要闭合的多面体几何图形。是否为闭合 3D 工具可用于确定多面体要素类是否包含闭合要素，封闭多面体工具可用于消除多面体要素中的空隙。

• 此工具是提供针对 3D 要素的分析函数的 3D 集合运算符。有关什么是集合运算符以及如何使用它们的详细信息，请参阅使用 3D 集合运算符。

• 如果选择了复杂输出表选项，则创建与给定输入要素相交的每个多面体的记录。一个要素可能落入多个闭合多面体要素内，从而在输出表中对应多个条目。

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

  • Target_ID - 输入要素的唯一 ID。
  • Status - 指示 Target_ID 字段标识的要素完全还是部分落入多面体内。
  • Container_ID - 标识与完全或部分落入的输入要素相交的多面体的唯一 ID。仅在选择复杂输出表选项时包括

语法

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

参数	说明	数据类型
in_target_feature_class	输入多面体或 3D 点、线或面要素类。	Feature Layer
in_container_feature_class	用作输入要素容器的闭合多面体要素。	Feature Layer
out_table	输出表，它提供全部或部分位于闭合输入多面体要素内部的 3D 输入要素的列表。输出表包含 OBJECTID（对象 ID）、Target_ID 和 Status 字段。Status 将指明输入要素 (Target_ID) 是否完全或部分落入多面体内。	Table
complex_output (可选)	指定输出表是否通过创建 Contain_ID 字段（识别包含输入要素的多面体要素）来识别输入要素和输入多面体要素之间的关系。 选中 - 将识别包含输入要素的多面体要素。 未选中 - 将不识别包含输入要素的多面体要素。这是默认设置。 指定输出表是否通过创建 Contain_ID 字段（识别包含输入要素的多面体要素）来识别输入要素和输入多面体要素之间的关系。 COMPLEX —识别包含输入要素的多面体要素。 SIMPLE —不识别包含输入要素的多面体要素。这是默认设置。	Boolean

代码实例

Inside3D 示例 1（Python 窗口）

下面的示例演示了如何在 Python 窗口中使用此工具：

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')

Inside3D 示例 2（独立脚本）

下面的示例演示了如何在独立 Python 脚本中使用此工具：

'''****************************************************************************
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)

环境

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

许可信息

ArcGIS for Desktop Basic:需要 3D Analyst

ArcGIS for Desktop Standard:需要 3D Analyst

ArcGIS for Desktop Advanced:需要 3D Analyst