摘要
确定来自输入要素类的 3D 要素是否包含在闭合的多面体中,并且写入记录要素(部分或全部在多面体中)的输出表。
插图
用法
所有输入要素都必须将 Z 信息存储为几何的一部分。如果基于字段的高度测量值在 2D 要素类中显示,则依据属性实现要素转 3D 工具可用于创建 3D 要素类。
-
此分析需要闭合的多面体几何图形。是否为闭合 3D 工具可用于确定多面体要素类是否包含闭合要素,封闭多面体工具可用于消除多面体要素中的空隙。
如果选择了复杂输出表选项,则创建与给定输入要素相交的每个多面体的记录。一个要素可能落入多个闭合多面体要素内,从而在输出表中对应多个条目。
输出表中会显示下列字段:
- Target_ID - 输入要素的唯一 ID。
- Status - 指示 Target_ID 字段标识的要素完全还是部分落入多面体内。
- Contain_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 字段(识别包含输入要素的多面体要素)来识别输入要素和输入多面体要素之间的关系。
| 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 Desktop Basic: 需要 3D Analyst
- ArcGIS Desktop Standard: 需要 3D Analyst
- ArcGIS Desktop Advanced: 需要 3D Analyst