Минимальный ограничивающий объем (3D Analyst)

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

Создает объекты-мультипатч, представляющие объем пространства, занятый набором 3D объектов.

Иллюстрация

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

• Метод Сфера или Конверт (geometry_type="SPHERE" или geometry_type = "ENVELOPE" в Python), позволяет быстро оценить объем пространства, занятый набором 3D объектов.

• Опция Выпуклая оболочка (geometry_type="CONVEX_HULL" в Python) предоставляет большую детальность, чем метод Сфера или Конверт, но не отображает локальные депрессии во входных объектах.

• Опция Выпуклая оболочка (geometry_type="CONCAVE_HULL" в Python) предоставляет большую детальность формы ограничивающего объема, но является утяжеляет вычисление и не должна использоваться с большими коллекциями входных данных.

• Когда результирующий минимальный ограничивающий объем представляет группы входных объекты, поля, используемые для разделения входных данных, будут добавлены в полученный мультипатч. Если геометрические характеристики включены в минимальный ограничивающий объем, то к выходным объектам будут добавлены следующие поля:

  • MBV_Area – общая площадь поверхности минимального ограничивающего объема
  • MBV_Volume – общий объем пространства, который занимает объект мультипатч

Параметры

Диалог

Подпись	Описание	Тип данных
Входные объекты	Набор данных LAS или 3D-объекты, для которых оценивается минимальный ограничивающий объем.	LAS Dataset Layer; Feature Layer
Z значение	Источник z-значений для входных данных.	Field
Выходной класс пространственных объектов	Класс объектов, который будет создан.	Feature Class
Тип выходного класса пространственных объектов (Дополнительный)	Указывает метод, применяемый для определения геометрии минимального ограничивающего объема. Выпуклая оболочка—Самая малая выпуклая область, охватывающая входные данные. Сфера—Наименьшая сфера, охватывающая входные данные. Конверт—Экстент XYZ для входных данных. Вогнутая оболочка—Вогнутая оболочка, охватывающая входные данные.	String
Опции группировки (Дополнительный)	Указывает, как будут сгруппированы входные объекты; каждая группа будет охвачена одним выходным мультипатчем. Нет—Входные объекты не будут сгруппированы. Используется по умолчанию. Эта опция не доступна для входных точечных объектов. Все—Все входные объекты будут рассматриваться как одна группа. Список—Входные объекты будут сгруппированы на основе их общих значений в заданном поле или полях в параметре поля группировки.	String
Поля группировки (Дополнительный)	Поле или поля входных объектов, которые будут использоваться для группировки пространственных объектов, когда задан Список в качестве Опции группировки. Для опции Список требуется как минимум одно поле группировки. Все пространственные объекты, имеющие одно значение в указанном поле или полях, будут рассматриваться как группа.	Field
Добавлять геометрические характеристики как атрибуты к выходным данным (Дополнительный)	Указывает, будет ли каждый объект связан с объемом и площадью поверхности минимального ограничивающего объема. Не отмечено – атрибуты геометрии не добавляются в выходной объект. Используется по умолчанию. Отмечено – атрибуты геометрии добавляются в выходной объект.	Boolean

Python

arcpy.ddd.MinimumBoundingVolume(in_features, z_value, out_feature_class, {geometry_type}, {group}, {group_field}, {mbv_fields})

Имя	Описание	Тип данных
in_features	Набор данных LAS или 3D-объекты, для которых оценивается минимальный ограничивающий объем.	LAS Dataset Layer; Feature Layer
z_value	Источник z-значений для входных данных.	Field
out_feature_class	Класс объектов, который будет создан.	Feature Class
geometry_type (Дополнительный)	Указывает метод, применяемый для определения геометрии минимального ограничивающего объема. CONVEX_HULL—Самая малая выпуклая область, охватывающая входные данные. SPHERE—Наименьшая сфера, охватывающая входные данные. ENVELOPE—Экстент XYZ для входных данных. CONCAVE_HULL—Вогнутая оболочка, охватывающая входные данные.	String
group (Дополнительный)	Указывает, как будут сгруппированы входные объекты; каждая группа будет охвачена одним выходным мультипатчем. NONE—Входные объекты не будут сгруппированы. Используется по умолчанию. Эта опция не доступна для входных точечных объектов. ALL—Все входные объекты будут рассматриваться как одна группа. LIST—Входные объекты будут сгруппированы на основе их общих значений в заданном поле или полях в параметре поля группировки.	String
group_field [group_field,...] (Дополнительный)	Поле или поля входных объектов, которые будут использоваться для группировки пространственных объектов, когда LIST задан как group_option. Для опции LIST требуется как минимум одно поле группировки. Все пространственные объекты, имеющие одно значение в указанном поле или полях, будут рассматриваться как группа.	Field
mbv_fields (Дополнительный)	Указывает, будут ли добавлены геометрические атрибуты в выходной класс объектов мультипатч. NO_MBV_FIELDS—Атрибуты геометрии не добавляются в выходной объект. Используется по умолчанию. MBV_FIELDS—Атрибуты геометрии добавляются в выходной объект.	Boolean

Пример кода

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

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

arcpy.env.workspace = 'C:/data'
arcpy.ddd.MinimumBoundingVolume('tree_canopy.shp', 'Shape.Z', 
                                'canopy_volume.shp', 'CONCAVE_HULL',
                                group='List', group_field='Season'
                                mbv_fields='MBV_FIELDS')

MinimumBoundingVolume, пример 2 (автономный скрипт)

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

'''****************************************************************************
Name: Detect Periods of Activity
Description: 
****************************************************************************'''
# Import system modules
import arcpy
import tempfile
import math

in_features = arcpy.GetParameterAsText(0)
out_volume = arcpy.GetParameterAsText(1)
grouping_field = arcpy.GetParameterAsText(2)


try:
    arcpy.MinimumBoundingVolume_3d(in_features, 'Shape.Z', out_volume, 
                                   'CONCAVE_HULL','LIST', group_field)

except arcpy.ExecuteError:
    print(arcpy.GetMessages())

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

Текущая рабочая область, Экстент, Выходная система координат, Географические преобразования

Особые случаи

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

• Basic: Обязательно 3D Analyst
• Standard: Обязательно 3D Analyst
• Advanced: Обязательно 3D Analyst