Справка

Агрегирование

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

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

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

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

Рисунок

Рисунок инструмента Агрегирование (Aggregate)
OutRas = Aggregate(InRas1, 3, Max, Expand, Data)

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

  • Если значения входного растра представлены целыми числами, и используется любой тип статистики, кроме опции Среднее (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
(дополнительно)

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

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

  • 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

# 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")

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

Связанные темы

Отзыв по этому разделу?