Минимальный ограничивающий объем (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

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

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