Краткая информация
Создает класс пространственных объектов, содержащий полигоны, которые представляют минимальные области, включающие каждый входной объект или каждую группу входных объектов.
Иллюстрация
Использование
Выходные полигональные объекты и их атрибуты будут варьироваться в зависимости от заданного типа геометрии и выбора группировки.
Параметр Опция группировки (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 будет установлено на ноль для обозначения этих случаев.
Синтаксис
MinimumBoundingGeometry_management (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 |
Пример кода
Минимальная ограничивающая геометрия. Пример 1 (окно Python)
Пример скрипта Python для выполнения функции Минимальная ограничивающая геометрия (Minimum Bounding Geometry) с запуском из окна Python в ArcGIS.
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")
Минимальная ограничивающая геометрия. Пример 2 (автономный скрипт)
Пример скрипта 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")
Параметры среды
- Текущая рабочая область (Current Workspace)
- Временная рабочая область (Scratch Workspace)
- Выходное значение Z по умолчанию (Default Output Z Value)
- Разрешение M (M Resolution)
- Допуск M (M Tolerance)
- Выходной домен M (Output M Domain)
- Выходной домен Z (Output Z Domain)
- Выходная система координат (Output Coordinate System)
- Экстент (Extent)
- Выходные данные содержат значения M (Output has M values)
- Выходные данные содержат Z значения (Output has Z values)
- Выходная пространственная сетка 1
- Выходная пространственная сетка 2
- Выходная пространственная сетка 3
- Разрешение XY (XY Resolution)
- Допуск XY (XY Tolerance)
- Разрешение Z (Z Resolution)
- Допуск Z (Z Tolerance)
Информация о лицензиях
- ArcGIS Desktop Basic: Да
- ArcGIS Desktop Standard: Да
- ArcGIS Desktop Advanced: Да