Agregar (Análisis espacial)

Resumen

Genera una versión de resolución reducida de un ráster. Cada celda de salida contiene la Suma, el Mínimo, el Máximo, el Valor medio o la Mediana de las celdas de entrada abarcadas por la extensión de esa celda.

Más información sobre cómo funciona Agregar

Ilustración

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

Uso

• Si los valores del ráster de entrada son enteros y se utiliza cualquier opción de tipo de estadística que no sea Valor medio, el ráster de salida será un entero. Si los valores del ráster de entrada son de punto flotante o el tipo de estadística es Valor medio, el ráster de salida será de punto flotante.

• Esta herramienta reconoce los entornos del análisis de geoprocesamiento Extensión y Tamaño de celda. Para determinar la resolución del ráster de salida cuando se especifica un tamaño de celda entero, multiplique la resolución de la celda del entorno de análisis por el parámetro de factor de la celda de entrada. Si el tamaño de celda para el entorno de análisis se establece en el mínimo o el máximo de las entradas, la resolución del ráster de salida será el producto de la resolución del ráster de entrada multiplicada por el factor de celda especificado.

Sintaxis

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

Parámetro	Explicación	Tipo de datos
in_raster	El ráster de entrada para agregar. Puede ser de tipo entero o punto flotante.	Raster Layer
cell_factor	El factor por el cual multiplicar el tamaño de celda del ráster de entrada para obtener la resolución deseada para el ráster de salida. Por ejemplo, un valor de factor de celda de tres generará como resultado un tamaño de celda de salida tres veces mayor que el del ráster de entrada. El valor debe ser un entero mayor que 1.	Long
aggregation_type (Opcional)	Establece cómo se determinará el valor para cada celda de salida. Los valores de las celdas de entrada abarcadas por la celda de salida más gruesa se agregan mediante una de las siguientes estadísticas: SUM —La suma (total) de los valores de celda de entrada. Esta es la opción predeterminada. MAXIMUM — El valor más grande de las celdas de entrada. MEAN — El valor promedio de las celdas de entrada. MEDIAN — El valor mediano de las celdas de entrada. MINIMUM — El valor más pequeño de las celdas de entrada.	String
extent_handling (Opcional)	Define cómo se gestionan los límites del ráster de entrada cuando sus filas o columnas no son múltiplos del factor de celda. EXPAND — Expande los límites inferiores o de la derecha del ráster de entrada de modo que la cantidad total de celdas en una fila o columna sea un múltiplo del factor de celda. Las celdas expandidas reciben el valor de NoData.Con esta opción, el ráster de salida puede cubrir una extensión espacial más amplia que la del ráster de entrada. Esta es la opción predeterminada. Esta es la opción predeterminada. TRUNCATE — Reduce la cantidad de filas o columnas en el ráster de salida en 1. Esto truncará las celdas restantes en los límites inferiores o de la derecha del ráster de entrada, de modo que la cantidad de filas o columnas en el ráster de entrada sea un múltiplo del factor de celda.Con esta opción, el ráster de salida puede cubrir una extensión espacial más reducida que la del ráster de entrada. Si la cantidad de filas y columnas en el ráster de entrada es un múltiplo de cell_factor, estas palabras clave no se utilizan.	Boolean
ignore_nodata (Opcional)	Indica que los valores NoData se ignorarán al añadir cálculos. DATOS — Especifica que, si existen valores NoData para cualquiera de las celdas que caen dentro de la extensión espacial de una celda más grande en el ráster de salida, se ignorarán los valores NoData cuando se determine el valor para las ubicaciones de celda de salida. Solo se utilizarán las celdas de entrada dentro de la extensión de la celda de salida que contengan valores de datos para determinar el valor de la celda de salida. Esta es la opción predeterminada. NODATA — Especifica que, si cualquiera de las celdas que caen dentro de la extensión espacial de una celda más grande en el ráster de salida tiene un valor de NoData, el valor para esa ubicación de celda de salida será NoData.Si se utiliza la palabra clave NODATA, está implícito que cuando las celdas dentro de una agregación contienen el valor NoData, no hay suficiente información para realizar los cálculos que se especificaron como necesarios para determinar un valor de salida.	Boolean

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	El ráster agregado de salida. Es una versión de resolución reducida del ráster de entrada.	Raster

Ejemplo de código

Ejemplo 1 de Agregar (ventana de Python)

En este ejemplo se agrega un ráster al promediar los valores con un factor de celda de 3 y se genera como salida un ráster 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")

Ejemplo 2 de Agregar (secuencia de comandos independiente)

En este ejemplo se agrega un ráster al promediar los valores con un factor de celda de 3 y se genera un ráster 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")

Entornos

Tamaño de celda, Espacio de trabajo actual, Sistema de coordenadas de salida, Extensión, Espacio de trabajo temporal, Alinear ráster

Información sobre licencias

ArcGIS for Desktop Basic: Requiere Spatial Analyst

ArcGIS for Desktop Standard: Requiere Spatial Analyst

ArcGIS for Desktop Advanced: Requiere Spatial Analyst