Минимальная ограничивающая геометрия (Управление данными)

Сводка

Создает класс пространственных объектов, содержащий полигоны, которые представляют минимальные области, включающие каждый входной объект или каждую группу входных объектов.

Иллюстрация

Иллюстрация инструмента Минимальная ограничивающая геометрия (Minimum Bounding Geometry).

Использование

  • Выходные полигональные объекты и их атрибуты будут варьироваться в зависимости от заданного типа геометрии и выбора группировки.

  • Лицензия:

    Опции Тип геометрии (Geometry Type), Выпуклая оболочка (Convex hull), Круг (Circle) и Внешние границы (Envelope) are доступны только с лицензией ArcGIS Desktop Advanced.

  • Параметр Опции группировки (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 – Диаметр результирующего круга.
  • В ряде случаев, во входном классе объектов могут присутствовать объекты, минимальная ограничивающая геометрия которых приведет к некорректным (с нулевой площадью) выходным полигонам. В этих случаях, маленькое значение, полученное из Допуска 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 будет установлено на ноль для обозначения этих случаев.

Синтаксис

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
(Дополнительный)

Указывает, какой тип минимальной ограничивающей геометрии будут представлять выходные полигоны.

  • RECTANGLE_BY_AREAПрямоугольник наименьшей площади, охватывающий входной объект. Это значение используется по умолчанию.
  • RECTANGLE_BY_WIDTHПрямоугольник наименьшей ширины, охватывающий входной объект.
  • CONVEX_HULLНаименьший выпуклый полигон (convex polygon), охватывающий входной объект.
  • CIRCLEНаименьший круг, охватывающий входной объект.
  • ENVELOPEВнешняя граница входного объекта.
Лицензия:

Опции Выпуклая оболочка (Convex hull), Круг (Circle) и Внешняя граница (Envelope) доступны только на уровне лицензии ArcGIS Desktop Advanced.

String
group_option
(Дополнительный)

Указывает, как будут сгруппированы входные объекты; каждая группа будет охвачена одним выходным полигоном.

  • NONEВходные объекты не будут сгруппированы. Это значение используется по умолчанию. Эта опция не доступна для входных точечных объектов.
  • ALLВсе входные объекты будут рассматриваться как одна группа.
  • LISTВходные объекты будут сгруппированы на основе их общих значений в заданном поле или полях в параметре поля группировки.
String
group_field
[group_field,...]
(Дополнительный)

Поле или поля входных объектов, которые будут использоваться для группировки пространственных объектов, когда LIST задан как group_option. Для опции LIST требуется, по крайней мере, одно поле группировки. Все пространственные объекты, имеющие одно значение в указанном поле или полях, будут рассматриваться как группа.

Field
mbg_fields_option
(Дополнительный)

Указывает, добавлять ли геометрические атрибуты в выходной класс объектов или пропускать их в выходном классе объектов.

  • NO_MBG_FIELDSПропускает входные атрибуты в выходном классе пространственных объектов. Это значение используется по умолчанию.
  • MBG_FIELDSДобавляет геометрические атрибуты в выходной класс объектов.
Boolean

Пример кода

Минимальная ограничивающая геометрия. Пример 1 (окно Python)

Пример скрипта 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")
Минимальная ограничивающая геометрия. Пример 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")

Информация о лицензиях

  • Basic: Ограничено
  • Standard: Ограничено
  • Advanced: Да

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