Построить пирамидные слои и статистику (Build Pyramids and Statistics) (Управление данными)
Резюме
Проходит по структуре папки, строит пирамиды и вычисляет статистику для всех наборов растровых данных, которые в нее входят. Также может построить пирамиды и вычислить статистику для всех элементов каталога растров или набора данных мозаики.
Использование
-
Построение пирамид повышает производительность отображения наборов растровых данных.
-
Вычисление статистики позволяет приложениям ArcGIS должным образом растягивать и отображать растровые данные.
-
Будут обрабатываться все поддерживаемые форматы растров.
-
Каталоги растров и наборы данных мозаики должны быть заданы в качестве входной рабочей области. Если рабочая область включает каталог растров или набор данных мозаики, то эти элементы не будут включены при запуске инструмента.
-
При коротковолновом сжатии наборов растровых данных, таких как ECW и MrSID, пирамидные слои не обязательно должны быть построены. Эти форматы имеют внутренние пирамидные слои, которые создаются при кодировании.
Синтаксис
| Параметр | Объяснение | Тип данных |
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 (дополнительно) |
Число пикселов по горизонтали между значениями. Значение должно быть больше 0 и меньше или равно общему числу столбцов в наборе растровых данных. По умолчанию 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 (дополнительно) | Выберите, хотите ли вы пропустить первый уровень пирамидных слоев. Пропуск первого уровня позволит сэкономить немного места на диске, но замедлит производительность на этих масштабах.
| Boolean |
resample_technique (дополнительно) |
Техника пересчета, используемая для построения ваших пирамидных слоев.
| String |
compression_type (дополнительно) |
Тип сжатия, используемый при построении пирамидных слоев растра.
| String |
compression_quality (дополнительно) |
Качество сжатия, которое будет использоваться при построении пирамидных слоев с методом сжатия JPEG. Значение должно быть между 0 и 100. Значения ближе к 100 дадут изображение более высокого качества, но степень сжатия будет ниже. | Long |
skip_existing (дополнительно) | Укажите, будет ли вычисляться статистика только там, где она отсутствует, или создавать ее заново, даже если она существует.
| Boolean |
Пример кода
Это пример на языке 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")
Это пример скрипта 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)