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

Сводка

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

Иллюстрация

Внутренний инструмент 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, которое идентифицирует объект-мультипатч, содержащий входной объект.

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

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

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

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