Внутри 3D (3D Analyst)

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

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

Иллюстрация

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

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

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

  • Для такого анализа требуется замкнутая геометрия мультипатч. Инструмент Замкнутые 3D можно использовать, чтобы определить, содержит ли класс объектов-мультипатчей замкнутые объекты. А инструмент Замкнуть мультипатч можно использовать для устранения разрывов в объектах-мультипатчах.

  • Если выбрана опция Комплексная выходная таблица (Complex Output Table), то запись создаётся для каждого мультипатча, который пересекает входной объект. Объект может попадать в несколько замкнутых объектов-мультипатчей и иметь несколько записей в выходной таблице.

  • В выходной таблице имеются следующие поля:

    • Target_ID – уникальный ID входного объекта.
    • Status – указывает, находится ли объект, идентифицированный полем Target_ID, полностью или частично внутри мультипатча.
    • Contain_ID – Отображает уникальный ID мультипатча, который пересекает входные объекты. Поле включается, только если выбрана опция Комплексная выходная таблица.

Параметры

ПодписьОписаниеТип данных
Входные объекты

Входной мультипатч или 3D точечный, линейный или полигональный класс пространственных объектов.

Feature Layer
Входные пространственные объекты-мультипатчи

Замкнутые объекты-мультипатчи, которые будут использоваться в качестве контейнеров для входных объектов.

Feature Layer
Выходная таблица

В выходной таблице представлен список 3D входных объектов, находящихся полностью или частично внутри замкнутых Входных объектов-мультипатчей (Input Multipatch Features). Выходная таблица содержит поля OBJECTID (ID объекта), Target_ID и Status. Поле Status указывает, находится ли входной объект (Target_ID) полностью или частично внутри мультипатча.

Table
Составная выходная таблица
(Дополнительный)

Указывает, идентифицирует ли выходная таблица отношения между Входными объектами и Входными объектами-мультипатчами; для этого создается поле Contain_ID, которое идентифицирует объект-мультипатч, содержащий входной объект.

  • Отмечено– объект-мультипатч, содержащий входной объект, будет идентифицироваться.
  • Не отмечено – объект-мультипатч, содержащий входной объект, не будет идентифицироваться. Это значение используется по умолчанию.
Boolean

arcpy.ddd.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 входных объектов, находящихся полностью или частично внутри замкнутых Входных объектов-мультипатчей (Input Multipatch Features). Выходная таблица содержит поля OBJECTID (ID объекта), Target_ID и Status. Поле Status указывает, находится ли входной объект (Target_ID) полностью или частично внутри мультипатча.

Table
complex_output
(Дополнительный)

Указывает, идентифицирует ли выходная таблица отношения между Входными объектами и Входными объектами-мультипатчами; для этого создается поле Contain_ID, которое идентифицирует объект-мультипатч, содержащий входной объект.

  • Отмечено– объект-мультипатч, содержащий входной объект, будет идентифицироваться.
  • Не отмечено – объект-мультипатч, содержащий входной объект, не будет идентифицироваться. Это значение используется по умолчанию.

Указывает, идентифицирует ли выходная таблица отношения между Входными объектами и Входными объектами-мультипатчами; для этого создается поле Contain_ID, которое идентифицирует объект-мультипатч, содержащий входной объект.

  • COMPLEXОбъект-мультипатч, содержащий входной объект, будет идентифицироваться.
  • SIMPLEОбъект-мультипатч, содержащий входной объект, не будет идентифицироваться. Это значение используется по умолчанию.
Boolean

Пример кода

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

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

arcpy.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

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

Связанные разделы