Внутри 3D (Инструменты 3D Analyst)

Краткая информация

Определяет, содержатся ли в замкнутом мультипатче 3D объекты входного класса, и заполняет выходную таблицу записями об объектах, которые частично или полностью находятся в пределах мультипатча.

Иллюстрация

Графика инструмента Внутри 3D

Использование

Все входные объекты должны иметь Z-информацию, хранящуюся в геометрии. Если в классе 2D-объектов присутствует поле с измерениями высоты, инструмент Объекты в 3D по атрибуту можно использовать для создания класса 3D-объектов.
Для такого анализа требуется замкнутая геометрия мультипатч. Инструмент Замкнутые 3D можно использовать, чтобы определить, содержит ли класс объектов-мультипатчей замкнутые объекты, а инструмент Замкнуть мультипатч можно использовать для устранения разрывов в объектах-мультипатчах.
Если выбрана опция Составная выходная таблица, для каждого мультипатча, с которым пересекается данный входной объект, создается отдельная запись. Объект может находиться в нескольких замкнутых мультипатчах и иметь несколько записей в выходной таблице.
В выходной таблице присутствуют следующие поля:
- Target_ID—Уникальный ID входного объекта.
- Status—Указывает, находится ли объект, идентифицируемый полем Target_ID, внутри или частично внутри мультипатча.
- Contain_ID—Определяет уникальный ID мультипатча, который пересекает входные объекты, находящиеся внутри или частично внутри. Включено только если выбрана опция Составная выходная таблица

Подпись	Объяснение	Тип данных
Входные объекты	Входной мультипатч или 3D точечный, линейный или полигональный класс пространственных объектов.	Feature Layer
Входные пространственные объекты-мультипатчи	Замкнутые объекты-мультипатчи, которые будут использоваться в качестве контейнеров для входных объектов.	Feature Layer
Выходная таблица	Выходная таблица, содержащая список 3D-объектов из значения параметра Входные объекты, которые находятся внутри или частично внутри замкнутых объектов из значения параметра Входные объекты-мультипатчи. Выходная таблица содержит поля `OBJECTID` (ID объекта), `Target_ID` и `Status`. В поле `Status` будет указано, находится ли входной элемент (``Target_ID`) внутри или частично внутри мультипатча.	Table
Составная выходная таблица (Дополнительный)	Задает, идентифицирует ли выходная таблица отношения между значениями параметров Входные объекты и Входные объекты мультипатч; для этого создается поле `Contain_ID`, которое идентифицирует объект мультипатч, содержащий входной объект. Отмечено–The multipatch feature that contains an input feature will be identified. Не отмечено–The multipatch feature that contains an input feature will not be identified. This is the default.	Boolean

arcpy.3d.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-объектов из значения параметра `in_target_feature_class`, которые находятся внутри или частично внутри замкнутых объектов из значения параметра `in_container_feature_class`. Выходная таблица содержит поля `OBJECTID` (ID объекта), `Target_ID` и `Status`. В поле `Status` будет указано, находится ли входной элемент (`Target_ID`) внутри или частично внутри мультипатча.	Table
complex_output (Дополнительный)	Задает, идентифицирует ли выходная таблица отношения между значениями параметров `in_target_feature_class` и `in_container_feature_class`; для этого создается поле `Contain_ID`, которое идентифицирует объект мультипатч, содержащий входной объект. `COMPLEX`–The multipatch feature that contains an input feature will be identified. `SIMPLE`–The multipatch feature that contains an input feature will not be identified. This is the default.	Boolean

Пример кода

'Inside3D', пример 1 (окно Python)

В следующем примере показано использование этого инструмента в окне Python:

arcpy.env.workspace = 'C:/data'
arcpy.ddd.Inside3D('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

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

# Run Inside3D
arcpy.ddd.Inside3D(inFC, inMP, outTbl)

Параметры среды

Текущая рабочая область, Выходное ключевое слово конфигурации, Автоподтверждение, Экстент

Информация о лицензировании

Basic: Требуется 3D Analyst
Standard: Требуется 3D Analyst
Advanced: Требуется 3D Analyst