Agregar (Análisis espacial)

Nivel de licencia:BasicStandardAdvanced

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

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

Uso

Sintaxis

Aggregate (in_raster, cell_factor, {aggregation_type}, {extent_handling}, {ignore_nodata})
ParámetroExplicaciónTipo 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:

  • SUMLa 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

NombreExplicaciónTipo 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

Temas relacionados

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
5/10/2014