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 funcionan las Estadísticas de celda
Ilustración
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.
La herramienta Estadísticas de celda crea una salida monobanda 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 de 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.
La herramienta Estadísticas de celda crea una salida multibanda al realizar el proceso como MULTI_BAND. Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.
Sintaxis
CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata}, {process_as_multiband})
Parámetro | 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á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á.
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.
| Boolean |
process_as_multiband (Opcional) | Especifica cómo se procesarán las bandas de ráster multibanda de entrada.
| Boolean |
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
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")
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")
Entornos
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