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

Краткая информация

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

Иллюстрация

Иллюстрация инструмента Минимальная ограничивающая геометрия

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

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

  • Параметр Опция группировки (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 будет задано как ноль, чтобы указывать на подобные случаи.

Параметры

ПодписьОписаниеТип данных
Входные объекты

Входными объектами могут быть точки, мультиточки, линии, полигоны или мультипатчи.

Feature Layer
Выходной класс пространственных объектов

Выходной класс полигональных объектов.

Feature Class
Тип геометрии
(Дополнительный)

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

  • Прямоугольник по площадиПрямоугольник наименьшей площади, охватывающий входной объект. Это значение по умолчанию
  • Прямоугольник по ширинеПрямоугольник наименьшей ширины, охватывающий входной объект.
  • Выпуклая оболочкаНаименьший выпуклый полигон, охватывающий входной объект.
  • КругНаименьший круг, охватывающий конверт входного объекта.
  • КонвертКонверт входного объекта
String
Опция группировки
(Дополнительный)

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

  • НетВходные объекты не будут сгруппированы. Это значение по умолчанию Эта опция не доступна для входных точечных объектов.
  • ВсеВсе входные объекты будут рассматриваться как одна группа.
  • СписокВходные объекты будут сгруппированы на основе их общих значений в заданном поле или полях в параметре поля группировки.
String
Поля группировки
(Дополнительный)

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

Field
Добавить геометрические характеристики в качестве атрибутов в выходные данные
(Дополнительный)

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

  • Не отмечено – не включает геометрические атрибуты в выходной класс объектов. Это значение по умолчанию
  • Отмечено – добавляет геометрические атрибуты в выходной класс объектов.
Boolean

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

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

  • RECTANGLE_BY_AREAПрямоугольник наименьшей площади, охватывающий входной объект. Это значение по умолчанию
  • RECTANGLE_BY_WIDTHПрямоугольник наименьшей ширины, охватывающий входной объект.
  • CONVEX_HULLНаименьший выпуклый полигон, охватывающий входной объект.
  • CIRCLEНаименьший круг, охватывающий конверт входного объекта.
  • ENVELOPEКонверт входного объекта
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

Пример кода

MinimumBoundingGeometry, пример 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")
MinimumBoundingGeometry, пример 2 (автономный скрипт)

Следующий автономный скрипт – это пример применения функции 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")

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