Краткая информация
Проходит по структуре папки, строит пирамидные слои и вычисляет статистику для всех наборов растровых данных, которые в нее входят. Также может построить пирамидные слои и вычислить статистику для всех элементов набора данных мозаики.
Использование
Построение пирамидных слоёв повышает производительность отображения наборов растровых данных
Вычисление статистики позволяет приложениям ArcGIS должным образом растягивать и отображать растровые данные.
Будут обрабатываться все поддерживаемые форматы растров.
Каталоги растров и наборы данных мозаики должны быть заданы в качестве входной рабочей области. Если рабочая область включает каталог растров или набор данных мозаики, то эти элементы не будут включены при запуске инструмента.
При коротковолновом сжатии наборов растровых данных, таких как ECW и MrSID, пирамидные слои не обязательно должны быть построены. Эти форматы имеют внутренние пирамидные слои, которые создаются при кодировании.
Синтаксис
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 (Дополнительный) | Данный параметр определяет, будут ли включены в работу инструмента подкаталоги с данными.
Каталоги растров и наборы данных мозаики должны быть заданы в качестве входной рабочей области. Если рабочая область включает каталог растров или набор данных мозаики, то эти элементы не будут включены при запуске инструмента. | Boolean |
build_pyramids (Дополнительный) | Укажите, строить ли пирамидные слои.
| Boolean |
calculate_statistics (Дополнительный) | Укажите, вычислять ли статистику.
| Boolean |
BUILD_ON_SOURCE (Дополнительный) | Укажите, построить ли пирамидные слои и вычислить статистику на исходные наборы растровых данных или вычислить статистику на элементы растра в наборе данных мозаики. Данная опция применяется только к наборам данных мозаики.
| Boolean |
block_field (Дополнительный) | Имя поля в атрибутивной таблице набора данных мозаики, которое служит для идентификации элементов, которые будут рассматриваться как один элемент при некоторых расчетах и операциях. | String |
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 создадут полный набор пирамид. | Long |
SKIP_FIRST (Дополнительный) | Выберите, хотите ли вы пропустить первый уровень пирамидных слоев. Пропуск первого уровня позволит сэкономить немного места на диске, но замедлит отображение при просмотре на следующих масштабах.
| Boolean |
resample_technique (Дополнительный) | Техника пересчета, используемая для построения ваших пирамидных слоев.
| String |
compression_type (Дополнительный) | Тип сжатия, используемый при построении пирамидных слоев растра.
| String |
compression_quality (Дополнительный) | Качество сжатия, которое будет использоваться при построении пирамидных слоев с методом сжатия JPEG. Значение должно быть в диапазоне от 0 до 100. Значения ближе к 100 дадут изображение более высокого качества, но степень сжатия будет ниже. | Long |
skip_existing (Дополнительный) | Укажите, будет ли вычисляться статистика только там, где она отсутствует, или создавать ее заново, даже если она существует.
| 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 Desktop Basic: Да
- ArcGIS Desktop Standard: Да
- ArcGIS Desktop Advanced: Да