Сводка
Строит пирамидные слои для вашего набора растровых данных.
Этот инструмент может также использоваться для удаления пирамидных слоев. Для удаления пирамидных слоев задайте параметру Уровни пирамидных слоев значение 0.
Иллюстрация
Использование
Построение пирамидных слоёв повышает производительность отображения наборов растровых данных.
Пирамидные слои необходимо построить только один раз для каждого набора данных. Пирамидные слои будут доступны при каждом отображении набора растровых данных.
Пирамидные слои не будут построены для наборов растровых данных, имеющих менее 1024 пикселей в строке или столбце. Пирамидные слои не нужны, если набор растровых данных достаточно маленький. Построение пирамидных слоев не поможет увеличить производительность.
При коротковолновом сжатии наборов растровых данных, таких как ECW и MrSID, пирамидные слои не обязательно должны быть построены. Эти форматы имеют внутренние пирамидные слои, которые создаются при кодировании.
Вы можете выбрать тип сжатия для файла просмотра пирамидного слоя, в Параметре среды Хранение растров. В результате сжатия будет создан файл с расширением .ovr меньшего размера. Формат IMAGINE и более старые версии ArcGIS будут создавать файлы набора данных уменьшенного разрешения (.rrd), для которых сжатие недоступно.
Сжатие пирамидного слоя по умолчанию будет использовать оптимальный тип сжатия, заданный типом данных. Вы можете вручную выбрать LZ77, JPEG или отсутствие сжатия.
Сжатие JPEG может использоваться только с теми форматами файлов, которые могут хранить данные в соответствии со спецификациями JPEG. Поддерживаемые форматы файлов наборов растровых данных – приводится список спецификаций, поддерживаемых форматом JPEG.
Синтаксис
arcpy.management.BuildPyramids(in_raster_dataset, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})
Параметр | Объяснение | Тип данных |
in_raster_dataset | Набор растровых данных, для которого вы хотите построить пирамидные слои. Входные данные должны иметь более 1024 строк и 1024 столбцов. | Raster Dataset; Raster Layer |
pyramid_level (Дополнительный) | Выберите количество слоев наборов данных с низким разрешением, которые будут построены. Значение по умолчанию равно -1, что позволит построить полные пирамидные слои. Если значение равно 0, не будет построено ни одного пирамидного слоя. Для удаления пирамидных слоев задайте для количества уровней значение 0. Максимальное количество пирамидных слоев, которое можно указать, равно 29. Значения выше или равное 30 будут преобразованы в -1, что приводит к созданию полного набора пирамид. | Long |
SKIP_FIRST (Дополнительный) | Выберите, хотите ли вы пропустить первый уровень пирамидных слоев. Пропуск первого уровня позволит сэкономить немного места на диске, но замедлит отображение при просмотре на следующих масштабах.
| Boolean |
resample_technique (Дополнительный) | Техника пересчета, используемая для построения пирамидных слоев.
| String |
compression_type (Дополнительный) | Тип сжатия, используемый при построении пирамидных слоев растра.
| String |
compression_quality (Дополнительный) | Качество сжатия, которое будет использоваться при построении пирамидных слоев с методом сжатия JPEG. Значение должно быть в диапазоне от 0 до 100. Значения ближе к 100 дадут изображение более высокого качества, но степень сжатия будет ниже. | Long |
skip_existing (Дополнительный) | Укажите, будут ли построены пирамидные слои только там, где они отсутствуют, или создавать их заново, даже если они существуют.
| Boolean |
Производные выходные данные
Имя | Объяснение | Тип данных |
out_raster | Выходной набор растровых данных. | Набор растровых данных |
Пример кода
BuildPyramids, пример 1 (окно Python)
Пример скрипта Python для инструмента BuildPyramids.
import arcpy
arcpy.BatchBuildPyramids_management(
"C:/data/img1.tif;C:/data/img2.img", "6", "SKIP_FIRST",
"BILINEAR", "JPEG", "50", "SKIP_EXISTING")
BuildPyramids, пример 2 (автономный скрипт)
Это пример скрипта Python для инструмента BuildPyramids.
#Build Pyramids for multiple raster datasets in the workspace
#Skip the dataset that already has pyramid
#Build pyramids with compression and level setting
import arcpy
arcpy.env.workspace = "C:/Workspace"
inras = "image1.tif;image2.img;fgdb.gdb/image3"
pylevels = "6"
skipfirst = "SKIP_FIRST"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"
arcpy.BatchBuildPyramids_management(
inras, pylevels, skipfirst, resample, compress,
quality, skipexist)
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да