Краткая информация
Проходит по структуре папки, строит пирамидные слои и вычисляет статистику для всех наборов растровых данных, которые в нее входят. Также может построить пирамидные слои и вычислить статистику для всех элементов набора данных мозаики.
Использование
Построение пирамидных слоёв повышает производительность отображения наборов растровых данных
Вычисление статистики позволяет приложениям 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)