Инструмент Агрегирование (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")