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

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