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

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

Краткая информация

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

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

Иллюстрация

OutRas = Aggregate(InRas1, 3, Max, Expand, Data)

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

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

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входной растр	Входной растр, который будет агрегирован. Может быть целочисленным или с плавающей точкой.	Raster Layer
Коэффициент ячеек	Коэффициент, на который следует умножать размер ячейки входного растра для получения требуемого разрешения выходного растра. Например, значение коэффициента ячеек, равное трем, позволит получить размер выходной ячейки в три раза больший, чем размер ячейки входного растра. Значение должно быть целым числом больше 1.	Long
Метод агрегирования (Дополнительный)	Устанавливает, как будет определяться значение для каждой выходной ячейки. Значения входных ячеек, охваченных выходной ячейкой более низкого разрешения, агрегируются по одной из следующих статистик: Сумма—Сумма (общая) значений входных ячеек. Это значение по умолчанию Максимум—Наибольшее значение входных ячеек. Среднее—Среднее значение входных ячеек. Медиана—Значение медианы входных ячеек. Минимум—Наименьшее значение входных ячеек.	String
Растянуть экстент, если необходимо (Дополнительный)	Определяет, как следует обрабатывать границы на входном растре, когда количество его строк или столбцов не кратно коэффициенту ячейки. Отмечено — Расширяет верхнюю или правую границы входного растра таким образом, чтобы общее число ячеек в строках или столбцах было кратно коэффициенту размера ячейки. При вычислении этим расширенным ячейкам присваивается значение NoData. При использовании этой опции выходной растр может охватывать больший пространственный экстент, чем входной растр. Это значение по умолчанию Не отмечено – Уменьшает число строк или столбцов в выходном растре. Это приведет к усечению оставшихся ячеек на верхней или правой границах входного растра, сделав число строк и столбцов входного растра кратным коэффициенту ячеек. При использовании этой опции выходной растр может охватывать меньший пространственный экстент, чем входной растр. Если число строк и столбцов на входном растре кратно коэффициенту ячейки Коэффициент ячеек, приведенные ниже ключевые слова не используются.	Boolean
Игнорировать значение NoData при вычислениях (Дополнительный)	Указывает на то, игнорируются ли значения NoData в вычислениях агрегирования. Отмечено — указывает, что, если любые ячейки, попадающие в пространственный экстент ячейки большего размера в выходном растре, имеют значение NoData, при определении значения для местоположений выходных ячеек значения NoData будут проигнорированы. При определении значений выходной ячейки будут использованы только те входные ячейки, которые попадают в экстент выходной ячейки и имеют действительное значение данных. Это значение по умолчанию Не отмечено — Определяет, что если любая ячейка, попадающая в пространственный экстент ячейки большего размера в выходном растре, имеет значение NoData, значением для этой выходной ячейки будет NoData. Если опция не отмечена, то подразумевается, что, при нахождении в области агрегирования ячеек со значением NoData, информации для выполнения заданных вычислений, необходимых для определения выходного значения недостаточно.	Boolean

Возвращаемое значение

Подпись	Описание	Тип данных
Выходной растр	Выходной агрегированный растр. Это версия растра уменьшенного разрешения.	Raster

Python

Aggregate(in_raster, cell_factor, {aggregation_type}, {extent_handling}, {ignore_nodata})

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

Возвращаемое значение

Имя	Описание	Тип данных
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")

Параметры среды

Автоматическое подтверждение, Размер ячейки, Метод проецирования размера ячейки, Сжатие, Текущая рабочая область, Экстент, Географические преобразования, Маска, Выходное ключевое слово CONFIG, Выходная система координат, Коэффициент параллельной обработки, Временная рабочая область, Растр привязки, Размер листа

Информация о лицензиях

• Basic: Обязательно Spatial Analyst
• Standard: Обязательно Spatial Analyst
• Advanced: Обязательно Spatial Analyst