Agregar (Spatial Analyst)

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

Ilustración de Agregar
OutRas = Aggregate(InRas1, 3, Max, Expand, Data)

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.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada

El ráster de entrada para agregar.

Puede ser de tipo entero o punto flotante.

Raster Layer
Factor de tamaño de celda

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
Técnica de agregación
(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:

  • SumaLa suma (total) de los valores de celda de entrada.Esta es la opción predeterminada.
  • MáximoEl valor más grande de las celdas de entrada.
  • MeanEl valor promedio de las celdas de entrada.
  • MedianaEl valor mediano de las celdas de entrada.
  • MínimoEl valor más pequeño de las celdas de entrada.
String
Ampliar la extensión si es necesario
(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.

  • Activado: expande los límites superiores o de la derecha del ráster de entrada para que la cantidad total de celdas de una fila o columna sea un múltiplo del factor de celda. A esas celdas expandidas se les otorga un valor de NoData cuando se introducen en el cálculo.

    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.

  • Desactivado: reduce la cantidad de filas o columnas del ráster de salida. Se truncarán 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 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 la cantidad de filas y columnas en el ráster de entrada es un múltiplo del Factor de tamaño de celda, estas palabras clave no se utilizan.

Boolean
Ignorar los NoData en los cálculos
(Opcional)

Indica que los valores NoData se ignorarán al añadir cálculos.

  • Activada: 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.

  • Desactivada: 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 Desactivada, 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

EtiquetaExplicaciónTipo 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.

Raster

Aggregate(in_raster, cell_factor, {aggregation_type}, {extent_handling}, {ignore_nodata})
NombreExplicació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.
  • MAXIMUMEl valor más grande de las celdas de entrada.
  • MEANEl valor promedio de las celdas de entrada.
  • MEDIANEl valor mediano de las celdas de entrada.
  • MINIMUMEl 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.

  • EXPANDExpande los límites superiores o de la derecha del ráster de entrada para que la cantidad total de celdas de una fila o columna sea un múltiplo del factor de celda. A esas celdas expandidas se les otorga un 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.
  • TRUNCATEReduce la cantidad de filas o columnas de un ráster de salida en 1. Se truncarán 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 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 que los valores NoData se ignorarán al añadir cálculos.

  • DATAEspecifica 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.
  • NODATAEspecifica 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

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

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

# Execute Aggregate
outAggreg = Aggregate(inRaster, cellFactor, "MEAN", "TRUNCATE", "NODATA")

# Save the output 
outAggreg.save("C:/sapyexamples/output/aggregate02")

Información de licenciamiento

  • Basic: Requiere Spatial Analyst
  • Standard: Requiere Spatial Analyst
  • Advanced: Requiere Spatial Analyst

Temas relacionados