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

Сводка

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

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

  • Построение пирамидных слоёв повышает производительность отображения наборов растровых данных

  • Вычисление статистики позволяет приложениям ArcGIS должным образом растягивать и отображать растровые данные.

  • Будут обрабатываться все поддерживаемые форматы растров.

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

  • При коротковолновом сжатии наборов растровых данных, таких как ECW и MrSID, пирамидные слои не обязательно должны быть построены. Эти форматы имеют внутренние пирамидные слои, которые создаются при кодировании.

Синтаксис

arcpy.management.BuildPyramidsandStatistics(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}, {where_clause}, {sips_mode})
ParameterОбъяснениеТип данных
in_workspace

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

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

Text File; Workspace; Raster Layer; Mosaic Layer
include_subdirectories
(Дополнительный)

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

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

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

Boolean
build_pyramids
(Дополнительный)

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

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

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

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

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

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

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

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

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

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

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

Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра.

Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра.

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

Long
y_skip_factor
(Дополнительный)

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

Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра.

Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра.

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

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

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

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

Long
pyramid_level
(Дополнительный)

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

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

Long
SKIP_FIRST
(Дополнительный)

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

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

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

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

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

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

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

Long
skip_existing
(Дополнительный)

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

  • SKIP_EXISTINGСтатистика будет вычислена, только если она еще не существует. Используется по умолчанию.
  • OVERWRITEСтатистика будет вычислена даже если она уже существует; существующая статистика будет перезаписана.
Boolean
where_clause
(Дополнительный)

SQL-выражение для выбора определенных растров, которые будут обрабатываться.

SQL Expression
sips_mode
(Дополнительный)

Указывает, следует ли разрешить построение пирамидных файлов с использованием ключевых процессов и алгоритмов, определенных в стандарте обработки изображений Softcopy (SIPS), NGA.STND.0014.

  • NONEПирамиды будут построены с использованием стандартных методов подвыборки. Используется по умолчанию.
  • SIPS_MODEПирамиды будут построены с использованием SIPS.
Boolean

Производные выходные данные

NameОбъяснениеТип данных
out_workspace

Обновленная выходная рабочая область.

Тестовый файл; Рабочая область; Растровый слой; Слой мозаики

Пример кода

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)

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

  • Basic: Да
  • Standard: Да
  • Advanced: Да

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