Построить контуры (Управление данными (Data Management))

Уровень лицензии:BasicStandardAdvanced

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

Вычисляет контуры для каждого набора растровых данных в наборе данных мозаики.

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

Синтаксис

BuildFootprints_management (in_mosaic_dataset, {where_clause}, {reset_footprint}, {min_data_value}, {max_data_value}, {approx_num_vertices}, {shrink_distance}, {maintain_edges}, {skip_derived_images}, {update_boundary}, {request_size}, {min_region_size}, {simplification_method}, {edge_tolerance}, {max_sliver_size}, {min_thinness_ratio})
ПараметрОбъяснениеТип данных
in_mosaic_dataset

Набор данных мозаики, для которого будут вычисляться контуры.

Image Service; Mosaic Layer; String
where_clause
(дополнительно)

Используя SQL, вы можете определить запрос или использовать Конструктор запросов для построения запроса.

SQL Expression
reset_footprint
(дополнительно)

Выберите, какой применить метод при повторном определении контуров.

  • RADIOMETRYПовторно определяет форму контура на основе диапазона значений пикселов. Эта опция обычно используется для переопределения контуров, чтобы исключить области границы, которые не определяют корректные данные. Это значение используется по умолчанию.
  • GEOMETRYПереопределяет форму контура, возвращая исходную геометрию.
  • COPY_TO_SIBLINGПри использовании панхроматического типа растра, контур панхроматического элемента будет заменен на контур спектрозонального элемента. Это происходит с некоторыми типами растра, если панхроматические и спектрозональные изображения имеют различные типы геометрии.
  • NONEКонтуры не будут переопределены.

Boolean; String
min_data_value
(дополнительно)

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

Например, с 8-битовыми данными значения могут быть в диапазоне от 0 до 255. Значение около 0 представляет очень темные цвета, такие как черные пикселы границы. Если вы зададите 1, то существует только одно значение, меньшее 1 – это 0, поэтому все значения 0 будут считаться некорректными данными и будут удалены из периметра контура. Если снимок сжат с помощью метода сжатия с потерями, вам нужно определить значение немного больше 1, чтобы удалить все черные пикселы. Если темные области, например, тени, были некорректно удалены из контура, это значение должно быть уменьшено.

Double
max_data_value
(дополнительно)

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

Например, с 8-битовыми данными значения могут быть в диапазоне от 0 до 255. Значение около 255 представляет очень светлые цвета, такие как белые облака и снег. Если вы зададите 245, то только значения от 246 до 255 будут удалены из периметра контура.

Double
approx_num_vertices
(дополнительно)

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

Минимальное значение равно 4, а максимальное – 10 000. Чем больше это значение, тем более точный и нерегулярный полигон, и тем дольше время обработки.

Значение -1 отображает все вершины в контуре; таким образом, контур полигона не будет обобщен.

Long
shrink_distance
(дополнительно)

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

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

Double
maintain_edges
(дополнительно)

Применяйте этот параметр при использовании наборов растровых данных, которые были разбиты на листы и соединены на границе (или линии вдоль швов, которые немного не перекрываются).

  • NO_MAINTAIN_EDGESВсе контуры будут изменены независимо от их соседних контуров. Это значение используется по умолчанию.
  • MAINTAIN_EDGESВыполняется анализ границ изображения, и края листов не удаляются.
Boolean
skip_derived_images
(дополнительно)

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

  • SKIP_DERIVED_IMAGESПолученные изображения, например, сервисные обзорные изображения, не будут откорректированы. Это значение используется по умолчанию.
  • NO_SKIP_DERIVED_IMAGESКонтуры всех полученных изображений будут откорректированы вместе с базовыми изображениями.
Boolean
update_boundary
(дополнительно)

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

  • UPDATE_BOUNDARYГраница будет построена или обновлена. Это значение используется по умолчанию.
  • NO_BOUNDARYГраница не будет построена или обновлена.
Boolean
request_size
(дополнительно)

Размер, к которому растр будет пересчитан при рассмотрении с использованием этого инструмента. Значение (например, 2 000) определяет измерение с помощью строк и столбцов.

Вы можете увеличить или уменьшить это значение на основе сложности растровых данных. Большее разрешение изображения дает большую точность в наборе растровых данных и тем самым увеличивает время обработки.

Значение 1 не изменяет разрешение контура; следовательно, выполняется расчет контура с исходным размером пиксела.

Размер запроса не может превышать размер растра, включенного в контуры. В этом случае значение автоматически будет равно размеру растра.

Long
min_region_size
(дополнительно)

Определяет фильтр, используемый для удаления отверстий, созданных в контуре.

Это значение задано в пикселах, и оно напрямую связано с Размером запроса (Request Size), а не с разрешением пикселов исходного растра.

Long
simplification_method
(дополнительно)

Упрощение сократит количество вершин, поскольку сжатые контуры могут повлиять на выполнение отображения.

Выберите, какой метод применить при повторном упрощении контуров.

  • NONEНи один метод упрощения не будет применен. Это значение используется по умолчанию.
  • CONVEX_HULLМинимальная ограничивающая геометрия для каждого контура будет использована для упрощения контура.
  • ENVELOPEКонверт каждого набора данных мозаики обеспечивает упрощенный контур.
String
edge_tolerance
(дополнительно)

Значение расстояния, заданное в единицах системы координат набора данных мозаики, по которому весь полигон будет уменьшен в размере. Это используется, если параметр maintain_edges задан как MAINTAIN_EDGES.

Это значение, для которого рассчитан допуск с учетом размера пиксела, соответствующего запрошенному пересчитанному растру, пустое по умолчанию.

Значение -1 рассчитает допуск с помощью среднего размера пиксела набора данных мозаики.

Double
max_sliver_size
(дополнительно)

Определяет фильтр, используемый для определения осколочной геометрии в контуре.

Полигоны, которые имеют размер меньше, чем max_sliver_size, считаются осколочными. Это значение задано в пикселах, и оно напрямую связано с Размером запроса (Request Size), а не с разрешением пикселов исходного растра.

Long
min_thinness_ratio
(дополнительно)

Определяет фильтр, используемый для удаления осколочной геометрии из контура.

Полигоны, которые имеют размер меньше, чем max_sliver_size и min_thinness_ratio, считаются осколочными и будут удалены из контура.

Double

Пример кода

Построить контуры. Пример (окно Python)

Это пример Python для инструмента Построить контуры (Build Footprints).

import arcpy
arcpy.BuildFootprints_management(
     "c:/data/Footprints.gdb/md", "#","RADIOMETRY",
     "1", "254", "25", "0", "#", "SKIP_DERIVED_IMAGES", 
     "UPDATE_BOUNDARY", "#", "#", "CONVEX_HULL")
Построить контуры. Пример 2 (автономное окно)

Это пример скрипта Python для инструмента Построить контуры (Build Footprints).

# Build Footprint by setting the valid pixel value range from 1 to 254
# Allow 25 vertices to be used to draw a single footprint polygon
# Skip the overviews image
# Build new boundary afterwards
# Build footprints based on minimum bounding geometry

import arcpy
arcpy.env.workspace = "C:/Workspace"

    
mdname = "Footprints.gdb/md"
query = "#"
method = "RADIOMETRY"
minval = "1"
maxval = "254"
nvertice = "25"
shrinkdis = "0"
maintainedge = "#"
skipovr = "SKIP_DERIVED_IMAGES"
updatebnd = "UPDATE_BOUNDARY"
requestsize = "#"
minregsize = "#"
simplify = "#"

arcpy.BuildFootprints_management(
     mdname, query, method, minval, maxval, nvertice, shrinkdis,
     maintainedge, skipovr, updatebnd, requestsize, minregsize, 
     simplify)

Параметры среды

Связанные темы

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

ArcGIS for Desktop Basic: Нет
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
5/10/2014