Внутри 3D (3D Analyst)
Резюме
Определяет, содержатся ли в замкнутом мультипатче 3D объекты входного класса, и заполняет выходную таблицу записями об объектах, которые частично или полностью находятся в пределах мультипатча.
Рисунок
Использование
Все входные объекты должны иметь информацию Z, хранящуюся как часть их геометрии. Если значения измерений высоты представлены в поле 2D класса пространственных объектов, то вы можете использовать инструмент Объекты в 3D по атрибуту (Feature To 3D By Attribute), чтобы создать 3D класс пространственных объектов.
-
Для такого анализа требуется замкнутая геометрия мультипатч. Инструмент Замкнутые 3D (Is Closed 3D) можно использовать, чтобы определить, содержит ли класс объектов мультипатч замкнутые объекты. А инструмент Замкнуть мультипатч (Enclose Multipatch) можно использовать для устранения разрывов в объектах мультипатч.
Этот инструмент – это оператор, предоставляющий аналитические функции для 3D объектов. Дополнительные сведения об операциях пересечения 3D объектов и их использовании см. в разделе Работа с операциями пересечения 3D объектов.
-
Если выбрана опция Комплексная выходная таблица (Complex Output Table), то запись создаётся для каждого мультипатча, который пересекает входной объект. Объект может попадать в несколько замкнутых объектов-мультипатчей и иметь несколько записей в выходной таблице.
-
В выходной таблице имеются следующие поля:
- Target_ID - уникальный ID входного объекта.
- Status - Указывает, находится ли объект, идентифицированнный полем Target_ID, полностью или частично внутри мультипатча.
- Contain_ID - Отображает уникальный ID мультипатча, который покрывает входные объекты полностью или частично. Поле включается, только если выбрана опция Комплексная выходная таблица (Complex Output Table).
Синтаксис
| Параметр | Объяснение | Тип данных |
in_target_feature_class |
Входной мультипатч или 3D точечный, линейный или полигональный класс пространственных объектов. | Feature Layer |
in_container_feature_class |
Замкнутые объекты-мультипатчи, которые будут использоваться в качестве контейнеров для входных объектов. | Feature Layer |
out_table |
В выходной таблице представлен список 3D входных объектов (Input Features), находящихся полностью или частично внутри замкнутых Входных объектов-мультипатчей (Input Multipatch Features). Выходная таблица содержит поля OBJECTID (object ID), Target_ID и Status. Поле Status указывает, находится ли входной объект (с Target_ID) полностью или частично внутри мультипатча. | Table |
complex_output (дополнительно) |
Определяет, будут ли в выходной таблице отображаться отношения между Входными объектами (Input Features) и Входными объектами мультипатчами (Input Multipatch Features); будет создано поле Contain_ID, в которое будут попадать все объекты-мультипатчи, содержащие входные пространственные объекты.
Определяет, будет ли выходная таблица использоваться в установке отношений между Входными объектами (Input Features) и Входными объектами мультипатчей (Input Multipatch Features), для реализации которых создаётся поле Contain_ID, где прописываются все входные объекты в пределах конкретного объекта-мультипатча.
| Boolean |
Пример кода
В следующем примере показано использование этого инструмента в окне 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')
В следующем примере показано использование этого инструмента в автономном скрипте 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)