Сводка
Определяет, содержатся ли в замкнутом мультипатче 3D объекты входного класса, и заполняет выходную таблицу записями об объектах, которые частично или полностью находятся в пределах мультипатча.
Иллюстрация
Использование
Все входные объекты должны иметь информацию Z, хранящуюся как часть их геометрии. Если значения измерений высоты представлены в поле 2D класса пространственных объектов, то вы можете использовать инструмент Объекты в 3D по атрибуту, чтобы создать 3D класс пространственных объектов.
-
Для такого анализа требуется замкнутая геометрия мультипатч. Инструмент Замкнутые 3D можно использовать, чтобы определить, содержит ли класс объектов-мультипатчей замкнутые объекты. А инструмент Замкнуть мультипатч можно использовать для устранения разрывов в объектах-мультипатчах.
Если выбрана опция Комплексная выходная таблица (Complex Output Table), то запись создаётся для каждого мультипатча, который пересекает входной объект. Объект может попадать в несколько замкнутых объектов-мультипатчей и иметь несколько записей в выходной таблице.
В выходной таблице имеются следующие поля:
- Target_ID – уникальный ID входного объекта.
- Status – указывает, находится ли объект, идентифицированный полем Target_ID, полностью или частично внутри мультипатча.
- Contain_ID – Отображает уникальный ID мультипатча, который пересекает входные объекты. Поле включается, только если выбрана опция Комплексная выходная таблица.
Синтаксис
arcpy.3d.Inside3D(in_target_feature_class, in_container_feature_class, out_table, {complex_output})
Parameter | Объяснение | Тип данных |
in_target_feature_class | Входной мультипатч или 3D точечный, линейный или полигональный класс пространственных объектов. | Feature Layer |
in_container_feature_class | Замкнутые объекты-мультипатчи, которые будут использоваться в качестве контейнеров для входных объектов. | Feature Layer |
out_table | В выходной таблице представлен список 3D входных объектов, находящихся полностью или частично внутри замкнутых Входных объектов-мультипатчей (Input Multipatch Features). Выходная таблица содержит поля OBJECTID (ID объекта), Target_ID и Status. Поле Status указывает, находится ли входной объект (Target_ID) полностью или частично внутри мультипатча. | Table |
complex_output (Дополнительный) | Указывает, идентифицирует ли выходная таблица отношения между Входными объектами и Входными объектами-мультипатчами; для этого создается поле Contain_ID, которое идентифицирует объект-мультипатч, содержащий входной объект.
Указывает, идентифицирует ли выходная таблица отношения между Входными объектами и Входными объектами-мультипатчами; для этого создается поле Contain_ID, которое идентифицирует объект-мультипатч, содержащий входной объект.
| Boolean |
Пример кода
В следующем примере показано использование этого инструмента в окне Python.
arcpy.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
# Set environment settings
arcpy.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)
Информация о лицензиях
- Basic: Требуется 3D Analyst
- Standard: Требуется 3D Analyst
- Advanced: Требуется 3D Analyst