Подпись | Описание | Тип данных |
Входные объекты | Входными объектами могут быть точки, мультиточки, линии, полигоны или мультипатчи. | Feature Layer |
Выходной класс пространственных объектов | Выходной класс полигональных объектов. | Feature Class |
Тип геометрии (Дополнительный) | Указывает, какой тип минимальной ограничивающей геометрии будут представлять выходные полигоны.
| String |
Опция группировки (Дополнительный) | Указывает, как будут сгруппированы входные объекты; каждая группа будет охвачена одним выходным полигоном.
| String |
Поля группировки (Дополнительный) | Поле или поля входных объектов, которые будут использоваться для группировки пространственных объектов, когда Список задан как Опция группировки. Для опции Список необходимо хотя бы одно поле группы. Все пространственные объекты, имеющие одно значение в указанном поле или полях, будут рассматриваться как группа. | Field |
Добавить геометрические характеристики в качестве атрибутов в выходные данные (Дополнительный) | Указывает, следует ли добавлять геометрические атрибуты в выходной класс пространственных объектов или пропустить их.
| Boolean |
Краткая информация
Создает класс объектов, который содержит полигоны, представляющие минимальную ограничивающую геометрию, охватывающую каждый входной объект или группу входных объектов.
Иллюстрация
Использование
Выходные полигональные объекты и их атрибуты будут варьироваться в зависимости от заданного типа геометрии и выбора группировки.
Параметр Опция группировки (group_option в Python) повлияет на выходные полигоны и атрибуты следующим образом:
- Если выбрать Нет, выходные объекты не группируются. Выходные полигональные объекты будут созданы для каждого входного объекта, итоговые полигоны могут пересекаться. Атрибуты входных объектов будут сохранены в выходном классе объектов. Новое поле ORIG_FID будет добавлено в выходной класс объектов и установлено на ID входных объектов.
- Если выбрать Все, для входных объектов будет создан один на всех выходной полигональный объект. Атрибуты входных объектов не будут поддерживаться в выходном классе объектов.
- Если выбрать Список, каждый набор входных объектов с одинаковыми значениями поля в заданных полях группы будет рассматриваться как группа. Выходной полигональный объект будет создан для каждой группы, итоговые полигоны могут пересекаться. Атрибуты входных объектов, используемые как поле или поля группы, будут сохранены в выходном классе объектов.
Каждый тип геометрии можно характеризовать по одному или нескольким уникальным измерениям. Эти измерения можно дополнительно добавить в выходные данные в качестве полей, как описано далее. Значения ширины, длины и диаметра измеряются в единицах объектов, углы ориентации – в десятичных градусах по часовой стрелке от направления на север. Префикс MBG_ указывает поле минимальной ограничивающей геометрии.
- Для Прямоугольника по площади и Прямоугольника по ширине новыми полями и измерениями являются:
- MBG_Width– Длина короткой стороны итогового прямоугольника.
- MBG_Length– Длина длинной стороны итогового прямоугольника.
- MBG_Orientation– Ориентация длинной стороны итогового прямоугольника.
- Для Конверта новыми полями и измерениями являются:
- MBG_Width– Длина короткой стороны итогового прямоугольника.
- MBG_Length– Длина длинной стороны итогового прямоугольника.
- Для Выпуклой оболочки новыми полями и измерениями являются:
- MBG_Width– Кратчайшее расстояние между любыми двумя вершинами выпуклой оболочки. (Оно может быть найдено между несколькими парами вершин, но будет использоваться первая найденная.)
- MBG_Length– Самое длинное расстояние между любыми двумя вершинами выпуклой оболочки, эти вершины называются антиподными парами или точками-антиподами. (Оно может быть найдено между несколькими парами вершин, но будет использоваться первая найденная.)
- MBG_APodX1– координата x первой точки в паре антиподов.
- MBG_APodY1– координата y первой точки в паре антиподов.
- MBG_APodX2– координата x второй точки в паре антиподов
- MBG_APodY2– координата y второй точки в паре антиподов
- MBG_Orientation– ориентация воображаемой линии, соединяющей антиподную пару.
- Для Круга новым полем и измерением является:
- MBG_Diameter– диаметр итогового круга.
- Для Прямоугольника по площади и Прямоугольника по ширине новыми полями и измерениями являются:
Есть особые случаи входных объектов, которые могут привести к недопустимым (с нулевой площадью) выходным полигонам. В этих случаях маленькое значение, полученное из XY допуска входных объектов, будет использоваться как ширина, длина или диаметр для создания выходных полигонов. Эти полигоны служат "заполнителями" для отслеживания объектов. Если итоговые полигоны выглядят "невидимыми" в ArcMap при использовании ширины контура полигона по умолчанию, измените его на более широкий символ линии контура, чтобы отобразить их. Примеры таких случаев:
- Если объект-мультиточка содержит только одну точку или группа таких объектов совпадает, вокруг точки будет создан очень маленький квадратный полигон для типов геометрии Прямоугольник по площади, Прямоугольник по ширине, Выпуклая оболочка и Конверт; для типа геометрии Круг будет создан очень маленький круг. Значения MBG_Width, MBG_Length, MBG_Orientation и MBG_Diameter будут заданы как ноль, чтобы указывать на подобные случаи.
- Если входной объект или группа входных объектов идеально выровнены, например, это горизонтальная или вертикальная линия или двухточечный объект-мультиточка, вокруг объекта будет создан прямоугольный полигон очень маленькой ширины. Это применимо к типам геометрии Прямоугольник по площади, Прямоугольник по ширине, Выпуклая оболочка и Конверт; итоговое значение MBG_Width будет задано как ноль, чтобы указывать на подобные случаи.
Параметры
arcpy.management.MinimumBoundingGeometry(in_features, out_feature_class, {geometry_type}, {group_option}, {group_field}, {mbg_fields_option})
Имя | Описание | Тип данных |
in_features | Входными объектами могут быть точки, мультиточки, линии, полигоны или мультипатчи. | Feature Layer |
out_feature_class | Выходной класс полигональных объектов. | Feature Class |
geometry_type (Дополнительный) | Указывает, какой тип минимальной ограничивающей геометрии будут представлять выходные полигоны.
| 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")
Следующий автономный скрипт – это пример применения функции MinimumBoundingGeometry в среде написания скриптов.
# 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")
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да