Доступно с лицензией Spatial Analyst.
Краткая информация
Создает версию растра уменьшенного разрешения. Каждая выходная ячейка содержит Сумму, Минимум, Максимум, Среднее или Медиану входных ячеек, которые попадают в пределы экстента этой ячейки.
Иллюстрация
Использование
Если значения входного растра представлены целыми числами, и используется любой тип статистики, кроме опции Среднее, выходной растр будет целочисленным. Если значения входного растра представлены значениями с плавающей точкой, или в качестве типа статистики используется опция Среднее, выходной растр будет содержать значения с плавающей точкой.
Этот инструмент использует параметры среды геообработки Экстент и Размер ячейки. Чтобы определить разрешение выходного растра, если задан размер ячейки задан целым числом, умножьте разрешение ячеек, установленное в параметрах среды анализа, на значение коэффициента ячейки. Если размер ячейки установлен как минимальный или максимальный из входных растров, разрешение выходного растра будет равно произведению разрешения входного растра и заданного коэффициента размера ячейки.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
Aggregate(in_raster, cell_factor, {aggregation_type}, {extent_handling}, {ignore_nodata})| Параметр | Объяснение | Тип данных |
in_raster | Входной растр, который будет агрегирован. Может быть целочисленным или с плавающей точкой. | Raster Layer |
cell_factor | Коэффициент, на который следует умножать размер ячейки входного растра для получения требуемого разрешения выходного растра. Например, значение коэффициента ячеек, равное трем, позволит получить размер выходной ячейки в три раза больший, чем размер ячейки входного растра. Значение должно быть целым числом больше 1. | Long |
aggregation_type (Дополнительный) | Устанавливает, как будет определяться значение для каждой выходной ячейки. Значения входных ячеек, охваченных выходной ячейкой более низкого разрешения, агрегируются по одной из следующих статистик:
| String |
extent_handling (Дополнительный) | Определяет, как следует обрабатывать границы на входном растре, когда количество его строк или столбцов не кратно коэффициенту ячейки.
Эти ключевые слова не используются, если число строк и столбцов во входном растре кратно cell_factor. | Boolean |
ignore_nodata (Дополнительный) | Указывает на то, игнорируются ли значения NoData в вычислениях агрегирования.
| Boolean |
Возвращаемое значение
| Имя | Объяснение | Тип данных |
| out_raster | Выходной агрегированный растр. Это версия растра уменьшенного разрешения. | Raster |
Пример кода
Aggregate, пример 1 (окно Python)
В этом примере агрегируется растр путем усреднения значений с коэффициентом ячеек 3, с сохранением результата в виде растра TIFF.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outAggreg = Aggregate("highres", 3, "MAXIMUM", "TRUNCATE", "DATA")
outAggreg.save("C:/sapyexamples/output/aggregate.tif")
Aggregate, пример 2 (автономный скрипт)
В этом примере агрегируется растр путем усреднения значений с коэффициентом ячеек 3, с сохранением результата в виде растра Grid.
# Name: Aggregate_Ex_02.py
# Description: Generates a reduced resolution version of a raster.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "highres"
cellFactor = 3
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Aggregate
outAggreg = Aggregate(inRaster, cellFactor, "MEAN", "TRUNCATE", "NODATA")
# Save the output
outAggreg.save("C:/sapyexamples/output/aggregate02")
Параметры среды
Информация о лицензиях
- Basic: Требуется Spatial Analyst
- Standard: Требуется Spatial Analyst
- Advanced: Требуется Spatial Analyst