Создает версию растра с уменьшенным разрешением. Каждая выходная ячейка содержит Сумму, Минимум, Максимум, Среднее или Медиану входных ячеек, которые попадают в пределы экстента этой ячейки.
Если Метод агрегирования задан как Максимум, Минимум или Сумма, тип выходного растра будет таким же, как и тип входного растра. При выборе метода Среднее или Медиана тип выходного растра всегда будет с плавающей точкой.
Этот инструмент использует параметры среды геообработки Экстент и Размер ячейки. Чтобы определить разрешение выходного растра, если задан размер ячейки задан целым числом, умножьте разрешение ячеек, установленное в параметрах среды анализа, на значение коэффициента ячейки. Если размер ячейки установлен как минимальный или максимальный из входных растров, разрешение выходного растра будет равно произведению разрешения входного растра и заданного коэффициента размера ячейки.
Коэффициент, на который умножается размер ячейки входного растра. Значение должно быть целым числом больше 1.
Например, значение коэффициента ячеек 3 дает размер выходной ячейки в три раза больший, чем размер ячейки входного растра.
Long
Метод агрегирования
(Дополнительный)
Метод, который будет использоваться для агрегирования.
Значения входных ячеек, заключенных в выходную ячейку более низкого разрешения, агрегируются по одной из следующих статистик:
Сумма–Сумма значений входных ячеек. Используется по умолчанию.
Максимальный–Наибольшее значение входных ячеек.
Среднее–Среднее значение входных ячеек.
Медиана–Значение медианы входных ячеек.
Минимум–Наименьшее значение входных ячеек.
String
Растянуть экстент, если необходимо
(Дополнительный)
Указывает, будут ли расширены границы входного растра, если его строки или столбцы не кратны коэффициенту ячейки.
Если число строк и столбцов во входном растре кратно cell_factor, этот параметр игнорируется.
Отмечено–Верхняя или правая границы входного растра будут расширены таким образом, чтобы общее количество ячеек в строке или столбце было кратно коэффициенту ячейки. Выходной растр может охватывать больший пространственный экстент, чем входной растр. При вычислении этим расширенным ячейкам присваивается значение NoData. Используется по умолчанию.
Не отмечено–Количество строк или столбцов в выходном растре будет уменьшено на 1. Это приведет к сокращению оставшихся ячеек на верхней или правой границах входного растра, а число строк или столбцов входного растра станет кратным коэффициенту ячеек. При использовании этой опции выходной растр может охватывать меньший пространственный экстент, чем входной растр.
Boolean
Игнорировать значение NoData при вычислениях
(Дополнительный)
Указывает на то, игнорируются ли значения NoData в вычислениях агрегирования.
Отмечено–Определяет, что если любые ячейки, попадающие в пространственный экстент ячейки большего размера в выходном растре, имеют значение NoData, при определении значения для местоположений выходных ячеек значения NoData будут проигнорированы. При определении значений выходной ячейки будут использованы только те входные ячейки, которые попадают в экстент выходной ячейки и имеют действительное значение данных. Используется по умолчанию.
Не отмечено–Определяет, что если любая ячейка, попадающая в пространственный экстент ячейки большего размера в выходном растре, имеет значение NoData, значением для этой выходной ячейки будет NoData. При использовании этой опции подразумевается, что если агрегируемые ячейки содержат значение NoData, то для выполнения указанных вычислений, необходимых для определения выходного значения, не хватает необходимой информации.
Коэффициент, на который умножается размер ячейки входного растра. Значение должно быть целым числом больше 1.
Например, значение коэффициента ячеек 3 дает размер выходной ячейки в три раза больший, чем размер ячейки входного растра.
Long
aggregation_type
(Дополнительный)
Метод, который будет использоваться для агрегирования.
Значения входных ячеек, заключенных в выходную ячейку более низкого разрешения, агрегируются по одной из следующих статистик:
SUM–Сумма значений входных ячеек. Используется по умолчанию.
MAXIMUM–Наибольшее значение входных ячеек.
MEAN–Среднее значение входных ячеек.
MEDIAN–Значение медианы входных ячеек.
MINIMUM–Наименьшее значение входных ячеек.
String
extent_handling
(Дополнительный)
Указывает, будут ли расширены границы входного растра, если его строки или столбцы не кратны коэффициенту ячейки.
Если число строк и столбцов во входном растре кратно cell_factor, этот параметр игнорируется.
EXPAND–Верхняя или правая границы входного растра будут расширены таким образом, чтобы общее количество ячеек в строке или столбце было кратно коэффициенту ячейки. Выходной растр может охватывать больший пространственный экстент, чем входной растр. При вычислении этим расширенным ячейкам присваивается значение NoData. Используется по умолчанию.
TRUNCATE–Количество строк или столбцов в выходном растре будет уменьшено на 1. Это приведет к сокращению оставшихся ячеек на верхней или правой границах входного растра, а число строк или столбцов входного растра станет кратным коэффициенту ячеек. При использовании этой опции выходной растр может охватывать меньший пространственный экстент, чем входной растр.
Boolean
ignore_nodata
(Дополнительный)
Указывает на то, игнорируются ли значения NoData в вычислениях агрегирования.
DATA–Определяет, что если любые ячейки, попадающие в пространственный экстент ячейки большего размера в выходном растре, имеют значение NoData, при определении значения для местоположений выходных ячеек значения NoData будут проигнорированы. При определении значений выходной ячейки будут использованы только те входные ячейки, которые попадают в экстент выходной ячейки и имеют действительное значение данных. Используется по умолчанию.
NODATA–Определяет, что если любая ячейка, попадающая в пространственный экстент ячейки большего размера в выходном растре, имеет значение NoData, значением для этой выходной ячейки будет NoData. При использовании этой опции подразумевается, что если агрегируемые ячейки содержат значение NoData, то для выполнения указанных вычислений, необходимых для определения выходного значения, не хватает необходимой информации.
Boolean
Возвращаемое значение
Имя
Объяснение
Тип данных
out_raster
Выходной агрегированный растр.
Это версия растра уменьшенного разрешения.
Raster
Пример кода
Aggregate пример 1 (окно Python)
В этом примере агрегируется растр путем усреднения значений с коэффициентом ячеек 3, с сохранением результата в виде растра TIFF.
В этом примере агрегируется растр путем усреднения значений с коэффициентом ячеек 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
# Run Aggregate
outAggreg = Aggregate(inRaster, cellFactor, "MEAN", "TRUNCATE", "NODATA")
# Save the output
outAggreg.save("C:/sapyexamples/output/aggregate02")
