Сводка
Проходит по структуре папки, строит пирамидные слои и вычисляет статистику для всех наборов растровых данных, которые в нее входят. Также может построить пирамидные слои и вычислить статистику для всех элементов набора данных мозаики.
Использование
Построение пирамидных слоёв повышает производительность отображения наборов растровых данных
Вычисление статистики позволяет приложениям 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})| Параметр | Объяснение | Тип данных |
in_workspace | Рабочая область, содержащая все наборы растровых данных, подлежащих обработке, набор данных мозаики или каталог растров. Если рабочая область включает каталог растров или набор данных мозаики, эти элементы не будут включены при запуске инструмента. | Text File; Mosaic Dataset; Workspace; Raster Catalog Layer; Raster Dataset; Mosaic Layer |
include_subdirectories (Дополнительный) | Данный параметр определяет, будут ли включены в работу инструмента подкаталоги с данными.
Каталоги растров и наборы данных мозаики должны быть заданы в качестве входной рабочей области. Если рабочая область включает каталог растров или набор данных мозаики, эти элементы не будут включены при запуске инструмента. | Boolean |
build_pyramids (Дополнительный) | Укажите, строить ли пирамидные слои.
| Boolean |
calculate_statistics (Дополнительный) | Укажите, вычислять ли статистику.
| Boolean |
BUILD_ON_SOURCE (Дополнительный) | Укажите, построить ли пирамидные слои и вычислить статистику исходных наборов растровых данных или вычислить статистику элементов растра в наборе данных мозаики. Данная опция применяется только к наборам данных мозаики.
| Boolean |
block_field (Дополнительный) | Имя поля в атрибутивной таблице набора данных мозаики, которое служит для идентификации элементов, которые будут рассматриваться как один элемент при некоторых расчетах и операциях. | String |
estimate_statistics (Дополнительный) | Указывает, производится ли расчет статистики для самого набора данных мозаики (не для имеющихся в нем растров). Эта статистика выводится на основе существующих статистик, рассчитанных для каждого растра в составе набора данных мозаики.
| Boolean |
x_skip_factor (Дополнительный) |
Число пикселов по горизонтали между значениями. Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра. Значение должно быть больше нуля и меньше или равно числу столбцов растра. По умолчанию используется 1 или последний коэффициент пропуска. | Long |
y_skip_factor (Дополнительный) | Число пикселов по вертикали между значениями. Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра. Значение должно быть больше 0 и меньше или равно общему числу строк в наборе растровых данных. По умолчанию 1 или последний использовавшийся коэффициент пропуска. | Long |
ignore_values [ignore_value,...] (Дополнительный) |
Значения пикселов, которые не будут включены в вычисление статистики. По умолчанию No Value (Нет значений). | Long |
pyramid_level (Дополнительный) | Выберите количество слоев наборов данных с низким разрешением, которые будут построены. Значение по умолчанию равно -1, что позволит построить полные пирамидные слои. Если значение равно 0, не будет построено ни одного пирамидного слоя. Максимальное количество пирамидных слоев, которое можно указать, равно 29. Все значения, равные 30 или больше, позволяют создать полный набор пирамидных слоев. | Long |
SKIP_FIRST (Дополнительный) | Выберите, хотите ли вы пропустить первый уровень пирамидных слоев. Пропуск первого уровня позволит сэкономить немного места на диске, но замедлит отображение при просмотре на следующих масштабах.
| Boolean |
resample_technique (Дополнительный) | Техника пересчета, используемая для построения пирамидных слоев.
| String |
compression_type (Дополнительный) | Тип сжатия, используемый при построении пирамидных слоев растра.
| String |
compression_quality (Дополнительный) | Качество сжатия, которое будет использоваться при построении пирамидных слоев с методом сжатия JPEG. Значение должно быть в диапазоне от 0 до 100. Значения ближе к 100 дадут изображение более высокого качества, но степень сжатия будет ниже. | Long |
skip_existing (Дополнительный) | Укажите, будет ли вычисляться статистика только там, где она отсутствует, или создавать ее заново, даже если она существует.
| Boolean |
where_clause (Дополнительный) | SQL-выражение для выбора определенных растров, которые будут обрабатываться. | SQL Expression |
Производные выходные данные
| Имя | Объяснение | Тип данных |
| out_workspace | Обновленная выходная рабочая область. | Text File; Workspace; Raster Layer; Mosaic Layer |
Пример кода
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: Да