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

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

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

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

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

Синтаксис

BuildPyramidsAndStatistics_management (in_workspace, {include_subdirectories}, {build_pyramids}, {calculate_statistics}, {BUILD_ON_SOURCE}, {block_field}, {estimate_statistics}, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})
ПараметрОбъяснениеТип данных
in_workspace

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

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

Mosaic Dataset; Mosaic Layer; Raster Catalog Layer; Raster Dataset; Text File; Workspace
include_subdirectories
(дополнительно)

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

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

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

Boolean
build_pyramids
(дополнительно)

Укажите, строить ли пирамидные слои.

  • NONEНе строить пирамидные слои.
  • BUILD_PYRAMIDSСтроить пирамидные слои. Это значение используется по умолчанию.
Boolean
calculate_statistics
(дополнительно)

Укажите, вычислять ли статистику.

  • NONEНе вычислять статистику.
  • CALCULATE_STATISTICSВычисляет статистику. Это значение используется по умолчанию.
Boolean
BUILD_ON_SOURCE
(дополнительно)

Укажите, построить ли пирамидные слои и вычислить статистику на исходные наборы растровых данных или вычислить статистику на элементы растра в наборе данных мозаики. Данная опция применяется только к наборам данных мозаики.

  • НетНе отмечено – Статистика будет вычисляться для каждого элемента растра в наборе данных мозаики (на каждую строку в таблице атрибутов). Любые функции, добавленные в элемент растра, будут применяться до создания статистики. Это значение используется по умолчанию.
  • BUILD_ON_SOURCEОтмечено – Строит пирамидные слои и вычисляет статистику для исходных данных набора данных мозаики.
Boolean
block_field
(дополнительно)

Имя поля в атрибутивной таблице набора данных мозаики, которое служит для идентификации элементов, которые будут рассматриваться как один элемент при некоторых расчетах и операциях.

String
estimate_statistics
(дополнительно)

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

  • НетДля набора данных мозаики статистика не вычисляется. Это значение используется по умолчанию.
  • ESTIMATE_STATISTICS (Оценить статистику)Для набора данных мозаики будет рассчитана статистика.
Boolean
x_skip_factor
(дополнительно)

Число пикселов по горизонтали между значениями.

Значение должно быть больше нуля и меньше или равно числу столбцов растра. По умолчанию используется 1 или последний коэффициент пропуска.

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

Число пикселов по вертикали между значениями.

Значение должно быть больше 0 и меньше или равно общему числу строк в наборе растровых данных. По умолчанию 1 или последний использовавшийся коэффициент пропуска.

Long
ignore_values
[ignore_value,...]
(дополнительно)

Значения пикселов, которые не будут включены в вычисление статистики.

По умолчанию No Value (Нет значений).

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

Выберите количество слоев наборов данных с низким разрешением, которые будут построены. Значение по умолчанию равно -1, что позволит построить полные пирамидные слои. Если значение равно 0, не будет построено ни одного пирамидного слоя.

Вы можете задать максимум 29 пирамидных слоев. Значения выше или равное 30 будут возвращены к значению -1, что создаст полный набор пирамид.

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

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

  • НетПервый уровень пирамидных слоев будет построен. Это значение используется по умолчанию.
  • SKIP_FIRSTПервый уровень пирамидных слоев не будет построен.
Boolean
resample_technique
(дополнительно)

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

  • NEARESTМетод ближайшего соседа использует значение ближайшей ячейки, чтобы присвоить значение для ячейки выходного растра при пересчете. Это значение используется по умолчанию.
  • BILINEARМетод пересчета билинейной интерполяции определяет новое значение ячейки на основании средневзвешенного расстояния для центров четырех ближайших входных ячеек.
  • CUBICМетод пересчета Кубическая свертка определяет новое значение ячейки на основании построения сглаживающей кривой через центры 16-ти ближайших входных ячеек.
String
compression_type
(дополнительно)

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

  • DEFAULTЕсли исходные данные сжимаются с использованием коротковолнового сжатия, то будут построены пирамидные слои с типом сжатия JPEG; в противном случае, будет использоваться LZ77. Это метод сжатия по умолчанию.
  • LZ77Для построения пирамидных слоев будет использоваться алгоритм сжатия LZ77. LZ77 может использоваться для любого типа данных.
  • JPEGАлгоритм сжатия JPEG для построения пирамидных слоев. Только те данные, которые строго соответствуют специфике сжатия JPEG, могут использовать этот тип сжатия. Если выбран JPEG, вы можете установить качество сжатия.
  • JPEG_YCbCrСжатие с потерями, использующее компоненты пространства цвета – яркость (Y) и цветность (Cb и Cr).
  • НетСжатие не будет использоваться при построении пирамидных слоев.
String
compression_quality
(дополнительно)

Качество сжатия, которое будет использоваться при построении пирамидных слоев с методом сжатия JPEG. Значение должно быть между 0 и 100. Значения ближе к 100 дадут изображение более высокого качества, но степень сжатия будет ниже.

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

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

  • SKIP_EXISTINGСтатистика будет вычислена, только если она еще не существует. Это значение используется по умолчанию.
  • OVERWRITEСтатистика будет вычислена, даже если она уже существует. Следовательно, существующая статистика будет перезаписана.
Boolean

Пример кода

BuildPyramidsandStatistics пример 1 (окно Python)

Это пример Python, иллюстрирующий применение инструмента BuildPyramidsandStatistics.

import arcpy
arcpy.BuildPyramidsAndStatistics_management(
     "C:/Workspace", "INCLUDE_SUBDIRECTORIES", "BUILD_PYRAMIDS",
     "CALCULATE_STATISTICS","BUILD_ON_SOURCE", "BlockField", 
     "ESTIMATE_STATISTICS", "10", "10", "0;255", "-1", "NONE",
     "BILINEAR", "JPEG", "50", "OVERWRITE")
BuildPyramidsandStatistics пример 2 (автономный скрипт)

Это пример скрипта Python, иллюстрирующий применение инструмента BuildPyramidsandStatistics.

#Build pyramids and calculate statistics for all raster in a folder

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

inws = "folder"
includedir = "INCLUDE_SUBDIRECTORIES"
buildpy = "BUILD_PYRAMIDS"
calcstats = "CALCULATE_STATISTICS"
buildsource = "NONE"
blockfield = "#"
estimatemd = "#"
skipx = "4"
skipy = "6"
ignoreval = "0;255"
pylevel = "3"
skipfirst = "NONE"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"

arcpy.BuildPyramidsAndStatistics_management(
     inws, includedir, buildpy, calcstats, buildsource, blockfield,
     estimatemd, skipx, skipy, ignoreval, pylevel, skipfirst,
     resample, compress, quality, skipexist)

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

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

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

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