ArcMap

3D 内部

描述

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

插图

Inside 3D tool graphic

使用

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

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

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

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

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

语法

Inside3D(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)

环境

许可信息

  • Basic: 需要 3D Analyst
  • Standard: 需要 3D Analyst
  • Advanced: 需要 3D Analyst

相关主题