Estadísticas de celdas (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Calcula una estadística por celda de rásteres múltiples.

Las estadísticas disponibles son mayoría, máximo, valor medio, mediana, mínimo, minoría, rango, desviación estándar, suma y variedad.

Más información sobre cómo funciona Estadísticas de celdas

Ilustración

Ejemplo de valores de entrada y salida de la herramienta Estadísticas de celdas
OutRas = CellStatistics([InRas1, InRas2, InRas3], "SUM", "NODATA", "SINGLE_BAND")

Uso

  • El orden de los rásteres de entrada es irrelevante para esta herramienta.

  • Para los tipos de estadística máximo, mínimo, valor medio, mediana, mayoría, minoría y suma, si se utiliza un ráster único como entrada, los valores de la celda de salida serán los mismos que los valores de la celda de entrada. Para Rango y Desviación estándar, los valores de la celda de salida serán todos de 0. Para Variedad, será 1.

  • Si el parámetro Procesar como multibanda está desactivado (process_as_multiband tiene el valor SINGLE_BAND en Python), cada banda de una entrada de ráster multibanda se procesa por separado como un ráster de banda única, y la salida es un ráster de banda única.

    Salida monobanda al realizar el proceso como SINGLE_BAND
    La herramienta Estadísticas de celdas crea una salida de banda única al realizar el proceso como SINGLE_BAND.
  • Si el parámetro Procesar como multibanda está activado (process_as_multiband tiene el valor MULTI_BAND en Python), cada banda de una entrada de ráster multibanda se procesa como un ráster multibanda, y la salida será un ráster multibanda. El ráster de salida también será multibanda si las entradas son una combinación de un ráster multibanda y constantes. El número de bandas en cada entrada multibanda debe ser el mismo.

    La herramienta realiza la operación con cada banda de una entrada utilizando la banda correspondiente de la otra entrada. Si una de las entradas es un ráster multibanda y la otra es una constante, la herramienta realizará la operación utilizando el valor constante para cada banda de la entrada multibanda.

    Salida multibanda al procesar como MULTI_BAND.
    La herramienta Estadísticas de celdas crea una salida multibanda al procesar como MULTI_BAND.
  • En ArcPy, si todas las entradas son rásteres multidimensionales con el mismo número de variables, la herramienta realizará la operación para todas las porciones con el mismo valor de dimensión y la salida será un ráster multidimensional. Las variables de las entradas deben tener las mismas dimensiones o dimensiones comunes.

    Si todas las entradas son rásteres multidimensionales con una variable, pero con nombres diferentes, establezca el entorno de geoprocesamiento matchMultidimensionalVariable en False para realizar la operación.

    En ArcPy, si una o varias de las entradas es un ráster multidimensional y la otra entrada es una constante, la herramienta realizará la operación en todas las porciones de todas las variables respecto al valor constante y la salida será un ráster multidimensional.

  • 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ásteres o valores constantes de entrada

Una lista de rásteres de entrada para los que se calcularán las estadísticas de cada celda dentro de la ventana Análisis.

Se puede utilizar un número como entrada; sin embargo, primero se debe establecer el tamaño de la celda y la extensión en el entorno.

Si el parámetro Procesar como multibanda está activado, todas las entradas multibanda deben tener el mismo número de bandas.

Raster Layer; Constant
Estadística de superposición
(Opcional)

Especifica el tipo de estadística que se calculará.

El tipo de estadísticas por defecto es el valor medio.

  • Valor medioSe calcula el valor medio (promedio) de las entradas.
  • MayoríaSe calcula la mayoría (valor que se produce con mayor frecuencia) de las entradas.
  • MáximoSe calcula el máximo (valor más grande) de las entradas.
  • MedianaSe calcula la mediana de las entradas.
  • MínimoSe calcula el mínimo (valor más pequeño) de las entradas.
  • MinoríaSe calcula la minoría (valor que ocurre con menos frecuencia) de las entradas.
  • RangoSe calcula el intervalo (diferencia entre el valor más grande y el más pequeño) de las entradas.
  • Desviación estándarSe calcula la desviación estándar de las entradas.
  • SumaSe calcula la suma (total de todos los valores) de las entradas.
  • VariedadSe calcula la variedad (el número de valores únicos) de las entradas.
String
Ignorar los NoData en los cálculos
(Opcional)

Especifica si los valores NoData serán ignorados por el cálculo de estadísticas.

  • Activado: en la ubicación de la celda de procesamiento, si alguno de los rásteres de entrada tiene NoData, ese valor NoData se pasará por alto. Las estadísticas se calcularán teniendo en cuenta únicamente las celdas con datos válidos. Esta es la opción predeterminada.
  • Desactivado: si la ubicación de la celda de procesamiento para alguno de los rásteres de entrada es NoData, la salida de esa celda será NoData.
Boolean
Procesar como multibanda
(Opcional)

Especifica cómo se procesarán las bandas de ráster multibanda de entrada.

  • Desactivado: cada banda de una entrada de ráster multibanda se procesará por separado como un ráster de una única banda. Esta es la opción predeterminada.
  • Activado: cada entrada de ráster multibanda se procesará como un ráster multibanda. La operación se realizará en cada banda a partir de una entrada mediante el uso del número de banda correspondiente de otras entradas.
Boolean

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de salida.

Para cada celda, el valor se determina aplicando el tipo de estadística especificado a los rásteres de entrada de esa ubicación.

Raster

CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata}, {process_as_multiband})
NombreExplicaciónTipo de datos
in_rasters_or_constants
[in_raster_or_constant,...]

Una lista de rásteres de entrada para los que se calcularán las estadísticas de cada celda dentro de la ventana Análisis.

Se puede utilizar un número como entrada; sin embargo, primero se debe establecer el tamaño de la celda y la extensión en el entorno.

Si el parámetro processing_as_multiband tiene el valor MULTI_BAND, todas las entradas multibanda deben tener el mismo número de bandas.

Raster Layer; Constant
statistics_type
(Opcional)

Especifica el tipo de estadística que se calculará.

  • MEANSe calcula el valor medio (promedio) de las entradas.
  • MAJORITYSe calcula la mayoría (valor que se produce con mayor frecuencia) de las entradas.
  • MAXIMUMSe calcula el máximo (valor más grande) de las entradas.
  • MEDIANSe calcula la mediana de las entradas.
  • MINIMUMSe calcula el mínimo (valor más pequeño) de las entradas.
  • MINORITYSe calcula la minoría (valor que ocurre con menos frecuencia) de las entradas.
  • RANGESe calcula el intervalo (diferencia entre el valor más grande y el más pequeño) de las entradas.
  • STDSe calcula la desviación estándar de las entradas.
  • SUMSe calcula la suma (total de todos los valores) de las entradas.
  • VARIETYSe calcula la variedad (el número de valores únicos) de las entradas.

El tipo de estadísticas por defecto es el valor medio.

String
ignore_nodata
(Opcional)

Especifica si los valores NoData serán ignorados por el cálculo de estadísticas.

  • DATAEn la ubicación de la celda de procesamiento, si alguno de los rásteres de entrada tiene NoData, ese valor NoData se pasará por alto. Las estadísticas se calcularán teniendo en cuenta únicamente las celdas con datos válidos. Esta es la opción predeterminada.
  • NODATASi la ubicación de la celda de procesamiento para alguno de los rásteres de entrada es NoData, la salida de esa celda será NoData.
Boolean
process_as_multiband
(Opcional)

Especifica cómo se procesarán las bandas de ráster multibanda de entrada.

  • SINGLE_BANDCada banda de una entrada de ráster multibanda se procesará por separado como un ráster de una única banda. Esta es la opción predeterminada.
  • MULTI_BANDCada entrada de ráster multibanda se procesará como un ráster multibanda. La operación se realizará en cada banda a partir de una entrada mediante el uso del número de banda correspondiente de otras entradas.
Boolean

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de salida.

Para cada celda, el valor se determina aplicando el tipo de estadística especificado a los rásteres de entrada de esa ubicación.

Raster

Muestra de código

Ejemplo 1 de CellStatistics (ventana de Python)

Este ejemplo calcula la desviación estándar por celda en varios rásteres de cuadrícula de entrada y genera el resultado como un ráster IMG.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCellStats = CellStatistics(["degs", "negs", "cost"], "STD", "DATA")
outCellStats.save("C:/sapyexamples/output/outcellstats.img")
Ejemplo 2 de CellStatistics (script independiente)

Este ejemplo calcula el rango de cada celda de cada banda de varios rásteres multibanda de entrada y crea un ráster multibanda de salida.

# Name: CellStatistics_Ex_standalone.py
# Description: Calculates a per-cell statistic from multiple multiband rasters
#               and process as multiband.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"

# Set the local variables
inRaster01 = "degs_MB"
inRaster02 = "negs_MB"
inRaster03 = "cost_MB"

# Execute CellStatistics
outCellStatistics = CellStatistics([inRaster01, inRaster02, inRaster03], "RANGE", "NODATA", "MULTI_BAND")

# Save the output 
outCellStatistics.save("C:/sapyexamples/output/cellstats_MB.tif")

Información de licenciamiento

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

Temas relacionados