Инструмент Агрегирование (Aggregate) (Spatial Analyst)
Краткая информация
Создает версию растра уменьшенного разрешения. Каждая выходная ячейка содержит Сумму (Sum), Минимум (Minimum), Максимум (Maximum), Среднее (Mean) или Медиану (Median) входных ячеек, которые попадают в пределы экстента этой ячейки.
Рисунок
 |
OutRas = Aggregate(InRas1, 3, Max, Expand, Data) |
Использование
-
Если значения входного растра представлены целыми числами, и используется любой тип статистики, кроме опции Среднее (Mean), выходной растр будет целочисленным. Если значения входного растра представлены значениями с плавающей точкой, или в качестве типа статистики используется опция Среднее, выходной растр будет содержать значения с плавающей точкой.
-
Этот инструмент использует параметры среды геообработки Экстент (Extent) и Размер ячейки (Cell size). Чтобы определить разрешение выходного растра, если задан размер ячейки задан целым числом, умножьте разрешение ячеек, установленное в параметрах среды анализа, на значение коэффициента ячейки. Если размер ячейки установлен как минимальный или максимальный из входных растров, разрешение выходного растра будет равно произведению разрешения входного растра и заданного коэффициента размера ячейки.
Синтаксис
| Параметр | Объяснение | Тип данных |
in_raster |
Входной растр, который будет агрегирован. Может быть целочисленным или с плавающей точкой. | Raster Layer |
cell_factor |
Коэффициент, на который следует умножать размер ячейки входного растра для получения требуемого разрешения выходного растра. Например, значение коэффициента ячеек, равное трем, позволит получить размер выходной ячейки в три раза больший, чем размер ячейки входного растра. Значение должно быть целым числом больше 1. | Long |
aggregation_type (дополнительно) |
Устанавливает, как будет определяться значение для каждой выходной ячейки. Значения входных ячеек, охваченных выходной ячейкой более низкого разрешения, агрегируются по одной из следующих статистик:
| String |
extent_handling (дополнительно) |
Определяет, как следует обрабатывать границы на входном растре, когда количество его строк или столбцов не кратно коэффициенту ячейки.
Если число строк и столбцов на входном растре кратно коэффициенту ячейки cell_factor, приведенные ниже ключевые слова не используются. | Boolean |
ignore_nodata (дополнительно) |
Указывает на то, игнорируются ли значения NoData в вычислениях агрегирования.
| Boolean |
Возвращено значение
| Имя | Объяснение | Тип данных |
| out_raster |
Выходной агрегированный растр. Это версия растра уменьшенного разрешения. | Raster |
Пример кода
В этом примере агрегируется растр путем усреднения значений с коэффициентом ячеек 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")
В этом примере агрегируется растр путем усреднения значений с коэффициентом ячеек 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")