Агрегировать (Spatial Analyst)

Доступно с лицензией Spatial Analyst.

Сводка

Создает версию растра уменьшенного разрешения. Каждая выходная ячейка содержит Сумму, Минимум, Максимум, Среднее или Медиану входных ячеек, которые попадают в пределы экстента этой ячейки.

Более подробно о том, как работает инструмент Агрегирование

Иллюстрация

Иллюстрация работы инструмента Агрегирование
OutRas = Aggregate(InRas1, 3, Max, Expand, Data)

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

  • Если Метод агрегирования задан как Максимум, Минимум или Сумма, тип выходного растра будет таким же, как и тип входного растра. При выборе метода Среднее или Медиана тип выходного растра всегда будет с плавающей точкой.

  • Этот инструмент использует параметры среды геообработки Экстент и Размер ячейки. Чтобы определить разрешение выходного растра, если задан размер ячейки задан целым числом, умножьте разрешение ячеек, установленное в параметрах среды анализа, на значение коэффициента ячейки. Если размер ячейки установлен как минимальный или максимальный из входных растров, разрешение выходного растра будет равно произведению разрешения входного растра и заданного коэффициента размера ячейки.

  • См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Синтаксис

Aggregate(in_raster, cell_factor, {aggregation_type}, {extent_handling}, {ignore_nodata})
ParameterОбъяснениеТип данных
in_raster

Входной растр, который будет агрегирован.

Может быть целочисленным или с плавающей точкой.

Raster Layer
cell_factor

Коэффициент, на который следует умножать размер ячейки входного растра для получения требуемого разрешения выходного растра.

Например, значение коэффициента ячеек, равное трем, позволит получить размер выходной ячейки в три раза больший, чем размер ячейки входного растра.

Значение должно быть целым числом больше 1.

Long
aggregation_type
(Дополнительный)

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

Значения входных ячеек, охваченных выходной ячейкой более низкого разрешения, агрегируются по одной из следующих статистик:

  • SUMСумма (общая) значений входных ячеек.Используется по умолчанию.
  • MAXIMUMНаибольшее значение входных ячеек.
  • MEANСреднее значение входных ячеек.
  • MEDIANЗначение медианы входных ячеек.
  • MINIMUMНаименьшее значение входных ячеек.
String
extent_handling
(Дополнительный)

Определяет, как следует обрабатывать границы на входном растре, когда количество его строк или столбцов не кратно коэффициенту ячейки.

  • EXPANDРасширяет верхнюю или правую границы входного растра таким образом, чтобы общее число ячеек в строках или столбцах было кратно коэффициенту размера ячейки. Расширенным ячейкам присваивается значение NoData.При использовании этой опции выходной растр может охватывать больший пространственный экстент, чем входной растр. Используется по умолчанию.
  • TRUNCATEУменьшает число строк или столбцов в выходном растре на 1. Это приведет к усечению оставшихся ячеек на верхней или правой границах входного растра, сделав число строк и столбцов входного растра кратным коэффициенту ячеек.При использовании этой опции выходной растр может охватывать меньший пространственный экстент, чем входной растр.

Эти ключевые слова не используются, если число строк и столбцов во входном растре кратно cell_factor.

Boolean
ignore_nodata
(Дополнительный)

Указывает на то, игнорируются ли значения NoData в вычислениях агрегирования.

  • DATAОпределяет, что если любые ячейки, попадающие в пространственный экстент ячейки большего размера в выходном растре, имеют значение NoData, при определении значения для местоположений выходных ячеек значения NoData будут проигнорированы. При определении значений выходной ячейки будут использованы только те входные ячейки, которые попадают в экстент выходной ячейки и имеют действительное значение данных.Это значение по умолчанию.
  • NODATAОпределяет, что если любая ячейка, попадающая в пространственный экстент ячейки большего размера в выходном растре, имеет значение NoData, значением для этой выходной ячейки будет NoData.Если используется данная опция, то подразумевается, что, если ячейки в пределах агрегирования содержат значение NoData, существует недостаточно информации для выполнения заданных вычислений, необходимых для определения выходного значения.
Boolean

Значение отраженного сигнала

NameОбъяснениеТип данных
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

# 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

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