Построить пирамидные слои и статистику (Инструменты Управление данными)

Краткая информация

Проходит по структуре папки, строит пирамидные слои и вычисляет статистику для всех наборов растровых данных, которые в нее входят. Также может построить пирамидные слои и вычислить статистику для всех элементов набора данных мозаики.

Использование

Построение пирамидных слоёв повышает производительность отображения наборов растровых данных.
Вычисление статистики позволяет приложениям ArcGIS должным образом растягивать и отображать растровые данные.
Будут обрабатываться все поддерживаемые форматы растров.
Если рабочая область содержит набор данных мозаики, будет включена только статистика, связанная с этим набором данных мозаики. Статистика, связанная с этими элементами в наборе данных мозаики, не будет включена.
При рекурсивном сжатии наборов растровых данных, таких как ECW и MrSID, нет необходимости в обязательном построении пирамидных слоев. Эти форматы имеют внутренние пирамидные слои, которые создаются при кодировании.

Подпись	Объяснение	Тип данных
Входные данные или рабочая область	Рабочая область, содержащая все наборы растровых данных или набор данных мозаики, подлежащие обработке. Если рабочая область содержит набор данных мозаики, будет включена только статистика, связанная с этим набором данных мозаики. Статистика, связанная с этими элементами в наборе данных мозаики, не будет включена, если не отмечен параметр Включить исходные наборы данных.	Text File; Workspace; Raster Layer; Mosaic Layer
Включить подкаталоги (Дополнительный)	Данный параметр определяет, будут ли включены в работу инструмента подкаталоги с данными. Если рабочая область содержит набор данных мозаики, будет включена только статистика, связанная с набором данных мозаики. Статистика, связанная с этими элементами в наборе данных мозаики, не будет включена. Отмечено–Включает все наборы растровых данных в пределах поддиректорий при загрузке. Используется по умолчанию. Не отмечено–Не отмечено – не включает поддиректории.	Boolean
Построить пирамидные слои (Дополнительный)	Определяет, будут ли построены пирамидные слои. Отмечено–Пирамидные слои будут построены. Используется по умолчанию. Не отмечено–Пирамидные слои не будут построены.	Boolean
Вычислить статистику (Дополнительный)	Укажите, вычислять ли статистику. Отмечено–Вычисляет статистику. Используется по умолчанию. Не отмечено–Не вычислять статистику.	Boolean
Включить исходные наборы данных (Дополнительный)	Укажите, вычислить ли статистику исходных наборов растровых данных или вычислить статистику элементов растра в наборе данных мозаики. Данная опция применяется только к наборам данных мозаики. Отмечено–Вычисляет статистику исходных данных набора данных мозаики. Не отмечено–Не отмечено – статистика будет вычисляться для каждого элемента растра в наборе данных мозаики (на каждую строку в таблице атрибутов). Любые функции, добавленные в элемент растра, будут применяться до создания статистики. Используется по умолчанию.	Boolean
Поле блока (Дополнительный)	Имя поля в атрибутивной таблице набора данных мозаики, которое служит для идентификации элементов, которые будут рассматриваться как один элемент при некоторых расчетах и операциях.	String
Оценить статистику набора данных мозаики (Дополнительный)	Указывает, производится ли расчет статистики для самого набора данных мозаики (не для имеющихся в нем растров). Эта статистика выводится на основе существующих статистик, рассчитанных для каждого растра в составе набора данных мозаики. Отмечено–Для набора данных мозаики будет рассчитана статистика. Не отмечено–Для набора данных мозаики статистика не вычисляется. Используется по умолчанию.	Boolean
Коэффициент пропуска по X (Дополнительный)	Число пикселов по горизонтали между выборками. Коэффициент пропуска управляет частью растра, которая используется при вычислении статистики. Входное значение указывает горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра. Значение должно быть больше нуля и меньше или равно числу столбцов растра. По умолчанию используется 1 или последний коэффициент пропуска.	Long
Коэффициент пропуска по Y (Дополнительный)	Число пикселов по вертикали между выборками. Коэффициент пропуска управляет частью растра, которая используется при вычислении статистики. Входное значение указывает горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра. Значение должно быть больше 0 и меньше или равно общему числу строк в наборе растровых данных. По умолчанию 1 или последний использовавшийся коэффициент пропуска.	Long
Игнорировать значения (Дополнительный)	Значения пикселов, которые не будут включены в вычисление статистики. По умолчанию нет значения.	Long
Уровни пирамидных слоев (Дополнительный)	Количество слоев наборов данных с низким разрешением, которые будут построены. Значение по умолчанию равно -1, что позволит построить полные пирамидные слои. Если значение равно 0, не будет построено ни одного пирамидного слоя. Максимальное количество пирамидных слоев, которое можно указать, равно 29. Все значения, равные 30 или больше, позволяют создать полный набор пирамидных слоев.	Long
Пропустить первый уровень (Дополнительный)	Задайте, будет ли пропущен первый уровень пирамидных слоев. Пропуск первого уровня позволит сэкономить немного места на диске, но замедлит отображение при просмотре на следующих масштабах. Отмечено–Пропустить первый уровень пирамидных слоев; он не будет построен. Не отмечено–Не пропускать первый уровень пирамидных слоев; он будет построен. Используется по умолчанию.	Boolean
Метод пересчета пирамидных слоев (Дополнительный)	Задает метод пересчета пирамидных слоев, который используется для построения пирамидных слоев. Ближайший сосед–Значение ближайшего пиксела используется, чтобы определить значение для пиксела выходного растра при пересчете. Используется по умолчанию. Билинейный–Новое значение пиксела, основанное на средневзвешенном расстоянии четырех ближайших центров входных пикселов. Кубическая свертка–Новое значение пиксела, основанное на построении сглаживающей кривой через центры 16-ти ближайших пикселов.	String
Тип сжатия пирамидных слоев (Дополнительный)	Задает тип сжатия пирамидных слоев, который будет использоваться при построении пирамидных слоев растра. По умолчанию–Если исходные данные сжимаются с использованием коротковолнового сжатия, пирамидные слои будут построены со сжатием JPEG; в противном случае используется LZ77. Используется по умолчанию. LZ77 Сжатие–Для построения пирамидных слоев будет использоваться алгоритм сжатия LZ77. Этот тип сжатия может использоваться для любого типа данных. JPEG Сжатие–Для построения пирамидных слоев будет использоваться алгоритм сжатия JPEG. Только те данные, которые строго соответствуют специфике сжатия JPEG, могут использовать этот тип сжатия. Если указан этот тип сжатия, можно задать значение параметра Качество сжатия. JPEG яркость и цветность–Будет использовано сжатие с потерями, использующее компоненты пространства цвета – яркость (Y) и цветность (Cb и Cr). Нет сжатия–Сжатие не будет использоваться при построении пирамидных слоев.	String
Качество сжатия (1-100) (Дополнительный)	Качество сжатия, которое будет использоваться при построении пирамидных слоев с типом сжатия JPEG. Значение должно быть в диапазоне от 0 до 100. Значения ближе к 100 дадут изображение более высокого качества, но степень сжатия будет ниже.	Long
Пропустить существующие (Дополнительный)	Укажите, будет ли вычисляться статистика только там, где она отсутствует, или создавать ее заново, даже если она существует. Отмечено–Статистика будет вычислена, только если она еще не существует. Используется по умолчанию. Не отмечено–Статистика будет вычислена даже если она уже существует; существующая статистика будет перезаписана.	Boolean
Определение запроса (Дополнительный)	SQL-выражение для выбора определенных растров, которые будут обрабатываться.	SQL Expression
Режим SIPS (Дополнительный)	Указывает, следует ли разрешить построение пирамидных файлов с использованием ключевых процессов и алгоритмов, определенных в стандарте обработки изображений Softcopy (SIPS), NGA.STND.0014. Отмечено–Пирамидные слои будут построены с использованием SIPS. Не отмечено–Пирамидные слои будут построены с использованием стандартных методов подвыборки. Используется по умолчанию.	Boolean

Производные выходные данные

Подпись	Объяснение	Тип данных
Обновленные Входные данные	Обновленная выходная рабочая область.	Text File; Workspace; Raster Layer; Mosaic Layer

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}, {sips_mode})

Имя	Объяснение	Тип данных
in_workspace	Рабочая область, содержащая все наборы растровых данных или набор данных мозаики, подлежащие обработке. Если рабочая область содержит набор данных мозаики, будет включена только статистика, связанная с этим набором данных мозаики. Статистика, связанная с этими элементами в наборе данных мозаики, не будет включена, если для параметра `BUILD_ON_SOURCE` не будет задано `BUILD_ON_SOURCE`.	Text File; Workspace; Raster Layer; Mosaic Layer
include_subdirectories (Дополнительный)	Данный параметр определяет, будут ли включены в работу инструмента подкаталоги с данными. Если рабочая область содержит набор данных мозаики, будет включена только статистика, связанная с набором данных мозаики. Статистика, связанная с этими элементами в наборе данных мозаики, не будет включена. `INCLUDE_SUBDIRECTORIES`–Включает все наборы растровых данных в пределах поддиректорий при загрузке. Используется по умолчанию. `NONE`–Не отмечено – не включает поддиректории.	Boolean
build_pyramids (Дополнительный)	Определяет, будут ли построены пирамидные слои. `BUILD_PYRAMIDS`–Пирамидные слои будут построены. Используется по умолчанию. `NONE`–Пирамидные слои не будут построены.	Boolean
calculate_statistics (Дополнительный)	Укажите, вычислять ли статистику. `CALCULATE_STATISTICS`–Вычисляет статистику. Используется по умолчанию. `NONE`–Не вычислять статистику.	Boolean
BUILD_ON_SOURCE (Дополнительный)	Укажите, вычислить ли статистику исходных наборов растровых данных или вычислить статистику элементов растра в наборе данных мозаики. Данная опция применяется только к наборам данных мозаики. `BUILD_ON_SOURCE`–Вычисляет статистику исходных данных набора данных мозаики. `NONE`–Не отмечено – статистика будет вычисляться для каждого элемента растра в наборе данных мозаики (на каждую строку в таблице атрибутов). Любые функции, добавленные в элемент растра, будут применяться до создания статистики. Используется по умолчанию.	Boolean
block_field (Дополнительный)	Имя поля в атрибутивной таблице набора данных мозаики, которое служит для идентификации элементов, которые будут рассматриваться как один элемент при некоторых расчетах и операциях.	String
estimate_statistics (Дополнительный)	Указывает, производится ли расчет статистики для самого набора данных мозаики (не для имеющихся в нем растров). Эта статистика выводится на основе существующих статистик, рассчитанных для каждого растра в составе набора данных мозаики. `ESTIMATE_STATISTICS`–Для набора данных мозаики будет рассчитана статистика. `NONE`–Для набора данных мозаики статистика не вычисляется. Используется по умолчанию.	Boolean
x_skip_factor (Дополнительный)	Число пикселов по горизонтали между выборками. Коэффициент пропуска управляет частью растра, которая используется при вычислении статистики. Входное значение указывает горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра. Значение должно быть больше нуля и меньше или равно числу столбцов растра. По умолчанию используется 1 или последний коэффициент пропуска.	Long
y_skip_factor (Дополнительный)	Число пикселов по вертикали между выборками. Коэффициент пропуска управляет частью растра, которая используется при вычислении статистики. Входное значение указывает горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра. Значение должно быть больше 0 и меньше или равно общему числу строк в наборе растровых данных. По умолчанию 1 или последний использовавшийся коэффициент пропуска.	Long
ignore_values [ignore_value,...] (Дополнительный)	Значения пикселов, которые не будут включены в вычисление статистики. По умолчанию нет значения.	Long
pyramid_level (Дополнительный)	Количество слоев наборов данных с низким разрешением, которые будут построены. Значение по умолчанию равно -1, что позволит построить полные пирамидные слои. Если значение равно 0, не будет построено ни одного пирамидного слоя. Максимальное количество пирамидных слоев, которое можно указать, равно 29. Все значения, равные 30 или больше, позволяют создать полный набор пирамидных слоев.	Long
SKIP_FIRST (Дополнительный)	Задайте, будет ли пропущен первый уровень пирамидных слоев. Пропуск первого уровня позволит сэкономить немного места на диске, но замедлит отображение при просмотре на следующих масштабах. `SKIP_FIRST`–Пропустить первый уровень пирамидных слоев; он не будет построен. `NONE`–Не пропускать первый уровень пирамидных слоев; он будет построен. Используется по умолчанию.	Boolean
resample_technique (Дополнительный)	Задает метод пересчета пирамидных слоев, который используется для построения пирамидных слоев. `NEAREST`–Значение ближайшего пиксела используется, чтобы определить значение для пиксела выходного растра при пересчете. Используется по умолчанию. `BILINEAR`–Новое значение пиксела, основанное на средневзвешенном расстоянии четырех ближайших центров входных пикселов. `CUBIC`–Новое значение пиксела, основанное на построении сглаживающей кривой через центры 16-ти ближайших пикселов.	String
compression_type (Дополнительный)	Задает тип сжатия пирамидных слоев, который будет использоваться при построении пирамидных слоев растра. `DEFAULT`–Если исходные данные сжимаются с использованием коротковолнового сжатия, пирамидные слои будут построены со сжатием JPEG; в противном случае используется LZ77. Используется по умолчанию. `LZ77`–Для построения пирамидных слоев будет использоваться алгоритм сжатия LZ77. Этот тип сжатия может использоваться для любого типа данных. `JPEG`–Для построения пирамидных слоев будет использоваться алгоритм сжатия JPEG. Только те данные, которые строго соответствуют специфике сжатия JPEG, могут использовать этот тип сжатия. Если указан этот тип сжатия, можно задать значение параметра Качество сжатия. `JPEG_YCBCR`–Будет использовано сжатие с потерями, использующее компоненты пространства цвета – яркость (Y) и цветность (Cb и Cr). `NONE`–Сжатие не будет использоваться при построении пирамидных слоев.	String
compression_quality (Дополнительный)	Качество сжатия, которое будет использоваться при построении пирамидных слоев с типом сжатия JPEG. Значение должно быть в диапазоне от 0 до 100. Значения ближе к 100 дадут изображение более высокого качества, но степень сжатия будет ниже.	Long
skip_existing (Дополнительный)	Укажите, будет ли вычисляться статистика только там, где она отсутствует, или создавать ее заново, даже если она существует. `SKIP_EXISTING`–Статистика будет вычислена, только если она еще не существует. Используется по умолчанию. `OVERWRITE`–Статистика будет вычислена даже если она уже существует; существующая статистика будет перезаписана.	Boolean
where_clause (Дополнительный)	SQL-выражение для выбора определенных растров, которые будут обрабатываться.	SQL Expression
sips_mode (Дополнительный)	Указывает, следует ли разрешить построение пирамидных файлов с использованием ключевых процессов и алгоритмов, определенных в стандарте обработки изображений Softcopy (SIPS), NGA.STND.0014. `SIPS_MODE`–Пирамидные слои будут построены с использованием SIPS. `NONE`–Пирамидные слои будут построены с использованием стандартных методов подвыборки. Используется по умолчанию.	Boolean

Производные выходные данные

Имя	Объяснение	Тип данных
out_workspace	Обновленная выходная рабочая область.	Text File; Workspace; Raster Layer; Mosaic Layer

Пример кода

BuildPyramidsandStatistics, пример 1 (окно Python)

Пример скрипта Python для инструмента BuildPyramidsAndStatistics.

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.env.pyramid = "PYRAMIDS 3 BILINEAR JPEG"
arcpy.env.rasterStatistics = "STATISTICS 4 6 (0)"
arcpy.management.BuildPyramidsandStatistics("folder", "INCLUDE_SUBDIRECTORIES",
                                            "BUILD_PYRAMIDS", "CALCULATE_STATISTICS")

BuildPyramidsAndStatistics, пример 2 (автономный скрипт)

Это пример скрипта Python для инструмента BuildPyramidsAndStatistics.

##====================================
##Build Pyramids and Statistics
##Usage: BuildPyramidsandStatistics_management in_workspace {INCLUDE_SUBDIRECTORIES
##                                                 | NONE} {BUILD_PYRAMIDS | NONE}
##                                                 {CALCULATE_STATISTICS | NONE}

try:
    import arcpy
    arcpy.env.workspace = r"C:/Workspace"

    ##Define parameters for build pyramids and calculate statitics in environment setting
    arcpy.env.pyramid = "PYRAMIDS 3 BILINEAR JPEG"
    arcpy.env.rasterStatistics = "STATISTICS 4 6 (0)"

    ##Build pyramids and calculate statistics for all raster in a folder
    arcpy.management.BuildPyramidsandStatistics("folder", "INCLUDE_SUBDIRECTORIES",
                                                "BUILD_PYRAMIDS", "CALCULATE_STATISTICS")

    ##Build pyramids and calculate statistics for all raster in a GDB
    arcpy.management.BuildPyramidsandStatistics("fgdb.gdb", "INCLUDE_SUBDIRECTORIES",
                                                "BUILD_PYRAMIDS", "CALCULATE_STATISTICS")

    ##Build pyramids and calculate statistics for all raster in a Mosaic Dataset
    arcpy.management.BuildPyramidsandStatistics("fgdb.gdb/md", "INCLUDE_SUBDIRECTORIES",
                                                "BUILD_PYRAMIDS", "CALCULATE_STATISTICS")

except:
    print("Build Pyramids and Statistics example failed.")
    print(arcpy.GetMessages())

Параметры среды

Коэффициент параллельной обработки, Пирамидный слой, Статистика растра

Информация о лицензировании

Basic: Да
Standard: Да
Advanced: Да

Построить пирамидные слои и статистику (Инструменты Управление данными)

Краткая информация

Использование

Параметры

Производные выходные данные

Параметры среды

Информация о лицензировании

Связанные разделы