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.
Para la configuración de Técnica de agregación de Máximo, Mínimo o Suma, el tipo de ráster de salida será el mismo que el del ráster de entrada. Si el ajuste es Valor medio o Mediana, el tipo de salida siempre será 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.
El factor por el que se multiplicará el tamaño de celda del ráster de entrada. El valor debe ser un entero mayor que 1.
Por ejemplo, un valor de factor de celda de 3 genera como resultado un tamaño de celda de salida tres veces mayor que el del ráster de entrada.
Long
Técnica de agregación
(Opcional)
El método que se utilizará para la agregación.
Los valores de las celdas de entrada abarcadas por las celdas de salida más gruesas se agregan mediante una de las siguientes estadísticas:
Suma—Total de los valores de celda de entrada. Esta es la opción predeterminada.
Máximo—El valor más grande de las celdas de entrada.
Valor medio—El valor promedio de las celdas de entrada.
Mediana—El valor mediano de las celdas de entrada.
Mínimo—El valor más pequeño de las celdas de entrada.
String
Ampliar la extensión si es necesario
(Opcional)
Especifica si los límites del ráster de entrada se expandirán cuando sus filas o columnas no sean múltiplos del factor de celda.
Si la cantidad de filas y columnas en el ráster de entrada es un múltiplo del cell_factor, este parámetro se ignora.
Activado—Los límites superior o derecho del ráster de entrada se expandirán para que la cantidad total de celdas de una fila o columna sea un múltiplo del factor de celda. El ráster de salida puede cubrir una extensión espacial más amplia que la del ráster de entrada. A esas celdas expandidas se les otorga un valor de NoData cuando se introducen en el cálculo. Esta es la opción predeterminada.
Desactivado—La cantidad de filas o columnas se reducirá en 1 en el ráster de salida. Se truncan el resto de celdas de los límites superiores o de la derecha del ráster de entrada, de tal forma que la cantidad de filas o columnas del ráster de entrada es 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.
Boolean
Ignorar los NoData en los cálculos
(Opcional)
Indica que los valores NoData se ignorarán en el cálculo de agregación.
Activado—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.
Desactivado—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
Etiqueta
Explicación
Tipo de datos
Ráster de salida
El ráster agregado de salida.
Es una versión de resolución reducida del ráster de entrada.
El factor por el que se multiplicará el tamaño de celda del ráster de entrada. El valor debe ser un entero mayor que 1.
Por ejemplo, un valor de factor de celda de 3 genera como resultado un tamaño de celda de salida tres veces mayor que el del ráster de entrada.
Long
aggregation_type
(Opcional)
El método que se utilizará para la agregación.
Los valores de las celdas de entrada abarcadas por las celdas de salida más gruesas se agregan mediante una de las siguientes estadísticas:
SUM—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)
Especifica si los límites del ráster de entrada se expandirán cuando sus filas o columnas no sean múltiplos del factor de celda.
Si la cantidad de filas y columnas en el ráster de entrada es un múltiplo del cell_factor, este parámetro se ignora.
EXPAND—Los límites superior o derecho del ráster de entrada se expandirán para que la cantidad total de celdas de una fila o columna sea un múltiplo del factor de celda. El ráster de salida puede cubrir una extensión espacial más amplia que la del ráster de entrada. A esas celdas expandidas se les otorga un valor de NoData cuando se introducen en el cálculo. Esta es la opción predeterminada.
TRUNCATE—La cantidad de filas o columnas se reducirá en 1 en el ráster de salida. Se truncan el resto de celdas de los límites superiores o de la derecha del ráster de entrada, de tal forma que la cantidad de filas o columnas del ráster de entrada es 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.
Boolean
ignore_nodata
(Opcional)
Indica que los valores NoData se ignorarán en 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
Aggregate ejemplo 1 (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.
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
# Run Aggregate
outAggreg = Aggregate(inRaster, cellFactor, "MEAN", "TRUNCATE", "NODATA")
# Save the output
outAggreg.save("C:/sapyexamples/output/aggregate02")
