Доступно с лицензией Spatial Analyst.
Краткая информация
Создает версию растра уменьшенного разрешения. Каждая выходная ячейка содержит Сумму, Минимум, Максимум, Среднее или Медиану входных ячеек, которые попадают в пределы экстента этой ячейки.
Иллюстрация
Использование
Если значения входного растра представлены целыми числами, и используется любой тип статистики, кроме опции Среднее (Mean), выходной растр будет целочисленным. Если значения входного растра представлены значениями с плавающей точкой, или в качестве типа статистики используется опция Среднее, выходной растр будет содержать значения с плавающей точкой.
Этот инструмент использует параметры среды геообработки Экстент (Extent) и Размер ячейки (Cell size). Чтобы определить разрешение выходного растра, если задан размер ячейки задан целым числом, умножьте разрешение ячеек, установленное в параметрах среды анализа, на значение коэффициента ячейки. Если размер ячейки установлен как минимальный или максимальный из входных растров, разрешение выходного растра будет равно произведению разрешения входного растра и заданного коэффициента размера ячейки.
См. раздел Параметры среды анализа и 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")
Параметры среды
- Автоподтверждение (Auto Commit)
- Размер ячейки (Cell size)
- Сжатие (Compression)
- Текущая рабочая область (Current Workspace)
- Экстент (Extent)
- Географические преобразования (Geographic Transformations)
- Маска (Mask)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходная система координат (Output Coordinate System)
- Статистика растра (Raster Statistics)
- Временная рабочая область (Scratch Workspace)
- Растр привязки (Snap Raster)
- Размер листа (Tile Size)
Информация о лицензиях
- ArcGIS Desktop Basic: Требует Spatial Analyst
- ArcGIS Desktop Standard: Требует Spatial Analyst
- ArcGIS Desktop Advanced: Требует Spatial Analyst