Agregar

Disponible con una licencia de Spatial Analyst.

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.

• Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

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 de un ráster de salida en 1. El resto de celdas de los límites inferiores o de la derecha del ráster de entrada se truncarán, de modo que la cantidad de filas o columnas en el ráster de entrada será 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 el número de filas y columnas del ráster de entrada es un múltiplo del cell_factor, estas palabras clave no se utilizan.	Boolean
ignore_nodata (Opcional)	Indica si los valores NoData serán ignorados por el cálculo de agregación. DATA — 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.El uso de esta opción implica 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

Muestra 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

• Auto ejecución
• Tamaño de celda
• Compresión
• Espacio de trabajo actual
• Extensión
• Transformaciones geográficas
• Máscara
• Palabra clave CONFIG de salida
• Sistema de coordenadas de salida
• Estadísticas de ráster
• Espacio de trabajo temporal
• Alinear ráster
• Tamaño de tesela

Información sobre licencias

• ArcGIS Desktop Basic: Requiere Análisis espacial
• ArcGIS Desktop Standard: Requiere Análisis espacial
• ArcGIS Desktop Advanced: Requiere Análisis espacial