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, Percentil, Rango, Desviación estándar, Suma y Variedad.

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

Ilustración

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, percentil 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 no está activado (process_as_multiband está establecido en SINGLE_BAND en Python), eaccada banda de un ráster multibanda de entrada se procesará por separado como un ráster de banda única, y la salida será un ráster de banda única.

  

  La herramienta Estadísticas de celda crea una salida de banda única cuando se procesa como SINGLE_BAND.

• Si el parámetro Procesar como multibanda está activado (process_as_multiband está establecido en MULTI_BAND en Python), cada ráster multibanda de entrada se procesará 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 de cada entrada multibanda debe ser el mismo.

  La herramienta realizará la operación en 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.

  

  La herramienta Estadísticas de celda crea una salida multibanda cuando se procesa como MULTI_BAND.

• Si todas las entradas son datos ráster 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. La salida será un ráster multidimensional en formato CRF. Las variables en las entradas deben tener al menos una dimensión común y un valor dimensional común para que esta herramienta procese; de lo contrario, se producirá un error.

  Si todas las entradas tienen una variable pero nombres diferentes, desactive el entorno de geoprocesamiento Variable multidimensional coincidente (definido como arcpy.env.matchMultidimensionalVariable = False en Python) antes de realizar la operación.

  Si una o varias de las entradas son rásteres multidimensionales y el resto de entradas son constantes, 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.

• Cuando hay un empate en los cálculos de mayoría y minoría, la salida será el más bajo de los valores coincidentes.

• Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Rásteres o valores constantes de entrada	Una lista de rásteres de entrada para los que se calculará una operación estadística de cada celda dentro de la ventana de 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 se activa el parámetro Procesar como multibanda, 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 Valor medio. Valor medio—Se calcula el valor medio (promedio) de las entradas. Esta es la opción predeterminada. Mayoría—Se determinará la mayoría (valor que se produce con mayor frecuencia) de las entradas. Máximo—Se determinará el máximo (valor más grande) de las entradas. Mediana—Se calcula la mediana de las entradas. Mínimo—Se determinará el mínimo (valor más pequeño) de las entradas. Minoría—Se determinará la minoría (valor que ocurre con menos frecuencia) de las entradas. Percentil—Se calculará el percentil de las entradas. El 90.º percentil se calcula de forma predeterminada. Puede especificar otros valores (del 0 al 100) con el parámetro Valor de percentil. Rango—Se calcula el intervalo (diferencia entre el valor más grande y el más pequeño) de las entradas. Desviación estándar—Se calcula la desviación estándar de las entradas. Suma—Se calcula la suma (total de todos los valores) de las entradas. Variedad—Se 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 percentil (Opcional)	Valor de percentil que se calculará. El valor predeterminado es 90, que indica el 90.º percentil. El valor puede variar de 0 a 100. El 0.º percentil equivale en esencia a la estadística mínimo, mientras que el 100.º percentil equivale a la estadística máximo. Un valor de 50 generará en esencia el mismo resultado que la estadística mediana. Este parámetro solo está disponible si el parámetro Estadística de superposición está establecido en Percentil.	Double
Tipo de interpolación de percentil (Opcional)	Especifica el método de interpolación que se debe utilizar cuando el valor de percentil especificado se encuentra entre dos valores de celda de entrada. Detección automática—Si los rásteres de entrada son de tipo píxel entero, se utilizará el método Más cercano. Si el ráster de entrada es de tipo punto flotante, se utiliza el método Lineal. Esta es la opción predeterminada. Más cercano—Se utilizará el valor disponible más cercano para el percentil deseado. En este caso, el tipo de píxel de salida será el mismo que el de los rásteres de entrada. Lineal—Se utilizará la media ponderada de los dos valores circundantes del percentil. En este caso, el tipo de píxel de salida será un punto flotante.	String

Valor de retorno

Etiqueta	Explicación	Tipo 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

Python

CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata}, {process_as_multiband}, {percentile_value}, {percentile_interpolation_type})

Nombre	Explicación	Tipo de datos
in_rasters_or_constants [in_raster_or_constant,...]	Una lista de rásteres de entrada para los que se calculará una operación estadística de cada celda dentro de la ventana de 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 se establece en 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á. MEAN—Se calcula el valor medio (promedio) de las entradas. Esta es la opción predeterminada. MAJORITY—Se determinará la mayoría (valor que se produce con mayor frecuencia) de las entradas. MAXIMUM—Se determinará el máximo (valor más grande) de las entradas. MEDIAN—Se calcula la mediana de las entradas. MINIMUM—Se determinará el mínimo (valor más pequeño) de las entradas. MINORITY—Se determinará la minoría (valor que ocurre con menos frecuencia) de las entradas. PERCENTILE—Se calculará el percentil de las entradas. El 90.º percentil se calcula de forma predeterminada. Puede especificar otros valores (del 0 al 100) con el parámetro percentile_value. RANGE—Se calcula el intervalo (diferencia entre el valor más grande y el más pequeño) de las entradas. STD—Se calcula la desviación estándar de las entradas. SUM—Se calcula la suma (total de todos los valores) de las entradas. VARIETY—Se calcula la variedad (el número de valores únicos) de las entradas. El tipo de estadísticas por defecto es MEAN.	String
ignore_nodata (Opcional)	Especifica si los valores NoData serán ignorados por el cálculo de estadísticas. DATA—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. NODATA—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
process_as_multiband (Opcional)	Especifica cómo se procesarán las bandas de ráster multibanda de entrada. SINGLE_BAND—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. MULTI_BAND—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
percentile_value (Opcional)	Valor de percentil que se calculará. El valor predeterminado es 90, que indica el 90.º percentil. El valor puede variar de 0 a 100. El 0.º percentil equivale en esencia a la estadística mínimo, mientras que el 100.º percentil equivale a la estadística máximo. Un valor de 50 generará en esencia el mismo resultado que la estadística mediana. Este parámetro solo está disponible si el parámetro statistics_type está establecido en PERCENTILE.	Double
percentile_interpolation_type (Opcional)	Especifica el método de interpolación que se debe utilizar cuando el valor de percentil especificado se encuentra entre dos valores de celda de entrada. AUTO_DETECT—Si los rásteres de entrada son de tipo píxel entero, se utilizará el método NEAREST. Si el ráster de entrada es de tipo punto flotante, se utiliza el método LINEAR. Esta es la opción predeterminada. NEAREST—Se utilizará el valor disponible más cercano para el percentil deseado. En este caso, el tipo de píxel de salida será el mismo que el de los rásteres de entrada. LINEAR—Se utilizará la media ponderada de los dos valores circundantes del percentil. En este caso, el tipo de píxel de salida será un punto flotante.	String

Valor de retorno

Nombre	Explicación	Tipo 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 (secuencia de comandos independiente)

Este ejemplo calcula el rango por celda por banda en 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")

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Compresión, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

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