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.
Ilustración
Uso
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 la técnica 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.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a 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:
| 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.
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 que los valores NoData se ignorarán al añadir cálculos.
| 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
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")
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
# Execute Aggregate
outAggreg = Aggregate(inRaster, cellFactor, "MEAN", "TRUNCATE", "NODATA")
# Save the output
outAggreg.save("C:/sapyexamples/output/aggregate02")
Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst