Сводка
Создает класс пространственных объектов, содержащий полигоны, которые представляют минимальные области, включающие каждый входной объект или каждую группу входных объектов.
Иллюстрация
Использование
Выходные полигональные объекты и их атрибуты будут варьироваться в зависимости от заданного типа геометрии и выбора группировки.
Параметр Опции группировки (Group Option) (group_option в Python) будет влиять на выходные полигоны и атрибуты следующими способами:
- При использовании Нет (None), ни один из входных объектов не будет сгруппирован. Выходной полигональный объект будет создан для каждого входного объекта; результирующие полигоны могут перекрываться. Атрибуты входных объектов будут скопированы в выходной класс объектов. Новое поле ORIG_FID будет добавлено к выходному классу объектов, оно будет содержать ID входных объектов.
- При использовании Все (All), один выходной полигональный объект будет создан для всех входных объектов. Атрибуты входных объектов не будут поддерживаться в выходном классе объектов.
- При использовании Список (List), каждый набор входных объектов с одинаковыми значениями поля в установленном поле(ях) группировки будет рассматриваться как группа. Для каждой группы будет создан выходной полигональный объект; результирующие полигоны могут перекрываться. Атрибуты входных объектов, используемые в качестве полей группировки или полей, будут поддерживаться в выходном классе объектов.
Каждый тип геометрии может быть охарактеризован одним или несколькими уникальными измерениями; эти измерения могут дополнительно быть добавлены к выходным данным в качестве новых полей, как описано ниже. Значения ширины, длины и диаметра – в единицах объектов; углы ориентировки – в десятичных градусах по часовой стрелке с севера. Префикс MBG_ указывает поле минимальной ограничивающей геометрии.
- Новые поля и измерения для Прямоугольника по площади (Rectangle by area) и Прямоугольника по ширине (Rectangle by width):
- MBG_Width – Длина самой короткой стороны результирующего прямоугольника.
- MBG_Length – Длина самой длинной стороны результирующего прямоугольника.
- MBG_Orientation – Ориентация самой длинной стороны результирующего прямоугольника.
- Новые поля и измерения для Внешней границы (Envelope):
- MBG_Width – Длина самой короткой стороны результирующего прямоугольника.
- MBG_Length – Длина самой длинной стороны результирующего прямоугольника.
- Для Convex hull новые поля и измерения следующие:
- MBG_Width – Кратчайшее расстояние между любыми двумя вершинами выпуклой оболочки. (Может находиться между более чем одной парой вершин, но будет использоваться первое найденное).
- MBG_Length – Наибольшее расстояние между двумя вершинами выпуклой оболочки; эти вершины называются парами-антиподами или точками-антиподами. (Может находиться между более чем одной парой вершин, но будет использоваться первое найденное).
- MBG_APodX1 – X координата первой точки из пары противоположных точек.
- MBG_APodY1 – Y координата первой точки из пары противоположных точек.
- MBG_APodX2 – X координата второй точки из пары противоположных точек.
- MBG_APodY2 – Y координата второй точки из пары противоположных точек.
- MBG_Orientation – Ориентация воображаемой линии, соединяющей пары-антиподы.
- Для Круг (Circle) новые поля и измерения следующие:
- MBG_Diameter – Диаметр результирующего круга.
- Новые поля и измерения для Прямоугольника по площади (Rectangle by area) и Прямоугольника по ширине (Rectangle by width):
В ряде случаев, во входном классе объектов могут присутствовать объекты, минимальная ограничивающая геометрия которых приведет к некорректным (с нулевой площадью) выходным полигонам. В этих случаях, маленькое значение, полученное из Допуска XY входного объекта, будет использоваться как ширина, длина или диаметр для создания выходных полигонов. Эти полигоны служат как "владельцы мест" для сохранения трека объектов. Если результирующие полигоны появляются "невидимыми" в ArcMap с использованием ширины контура полигона по умолчанию, измените на линейный символ более тонкого контура для их отображения. Примеры этих случаев включают:
- Если мультиточечный объект содержит только одну точку или группу таких совпадающих объектов, очень малый квадратный полигон будет создан вокруг точки для типов геометрии Прямоугольник по площади (Rectangle by area), Прямоугольник по ширине (Rectangle by width), Выпуклая оболочка (Convex hull) и Внешняя граница (Envelope); и очень малый круг – для типа геометрии Круг (Circle). Значения MBG_Width, MBG_Length, MBG_Orientation и MBG_Diameter будут установлены на ноль для обозначения этих случаев.
- Если входной объект или группа входных объектов идеально выровнены, например, горизонтальная или вертикальная линии или мультиточечные объекты из двух точек, вокруг объектов будет создан прямоугольный полигон очень маленькой ширины. Это применяется к типам геометрии Прямоугольник по площади (Rectangle by area), Прямоугольник по ширине (Rectangle by width), Выпуклая оболочка (Convex hull) и Внешняя граница (Envelope); результирующее значение MBG_Width будет установлено на ноль для обозначения этих случаев.
Лицензия:
Опции Тип геометрии (Geometry Type), Выпуклая оболочка (Convex hull), Круг (Circle) и Внешние границы (Envelope) are доступны только с лицензией ArcGIS Desktop Advanced.
Синтаксис
arcpy.management.MinimumBoundingGeometry(in_features, out_feature_class, {geometry_type}, {group_option}, {group_field}, {mbg_fields_option})
Parameter | Объяснение | Тип данных |
in_features | Входные объекты, которые могут быть точками, мультиточками, линиями, полигонами или мультипатчами. | Feature Layer |
out_feature_class | Выходной класс полигональных объектов. | Feature Class |
geometry_type (Дополнительный) | Указывает, какой тип минимальной ограничивающей геометрии будут представлять выходные полигоны.
Лицензия:Опции Выпуклая оболочка (Convex hull), Круг (Circle) и Внешняя граница (Envelope) доступны только на уровне лицензии ArcGIS Desktop Advanced. | String |
group_option (Дополнительный) | Указывает, как будут сгруппированы входные объекты; каждая группа будет охвачена одним выходным полигоном.
| String |
group_field [group_field,...] (Дополнительный) | Поле или поля входных объектов, которые будут использоваться для группировки пространственных объектов, когда LIST задан как group_option. Для опции LIST требуется, по крайней мере, одно поле группировки. Все пространственные объекты, имеющие одно значение в указанном поле или полях, будут рассматриваться как группа. | Field |
mbg_fields_option (Дополнительный) | Указывает, добавлять ли геометрические атрибуты в выходной класс объектов или пропускать их в выходном классе объектов.
| Boolean |
Пример кода
Пример скрипта Python для выполнения функции MinimumBoundingGeometry в режиме прямого запуска.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.MinimumBoundingGeometry_management("parks.shp",
"c:/output/output.gdb/parks_mbg",
"RECTANGLE_BY_AREA", "NONE")
Пример скрипта Python для выполнения функции Минимальная ограничивающая геометрия (Minimum Bounding Geometry) в автономном режиме.
# Name: MinimumBoundingGeometry.py
# Description: Use MinimumBoundingGeometry function to find an area
# for each multipoint input feature.
# import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Create variables for the input and output feature classes
inFeatures = "treeclusters.shp"
outFeatureClass = "forests.shp"
# Use MinimumBoundingGeometry function to get a convex hull area
# for each cluster of trees which are multipoint features
arcpy.MinimumBoundingGeometry_management(inFeatures, outFeatureClass,
"CONVEX_HULL", "NONE")
Environments
Информация о лицензиях
- Basic: Ограничено
- Standard: Ограничено
- Advanced: Да