Disponible con una licencia de Spatial 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.
Cuando se especifica un ráster multibanda como uno de los Rásteres o valores constantes de entrada (in_rasters_or_constants en Python), se utilizarán todas las bandas.
Para procesar una selección de bandas a partir de un ráster multibanda, puede crear primero un dataset ráster nuevo formado por esas bandas concretas con la herramienta Bandas compuestas y utilizar el resultado en la lista de Rásteres o valores constantes de entrada (in_rasters_or_constants en Python).
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 STD, los valores de la celda de salida serán todos de 0 y, para Variedad, 1.
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})
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. | Raster Layer; Constant |
statistics_type (Opcional) | Tipo de estadísticas a calcular.
El tipo de estadísticas por defecto es el valor medio. | String |
ignore_nodata (Opcional) | Indica si los valores NoData serán ignorados por el cálculo de estadísticas.
| 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
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 la desviación estándar por celda en varios rásteres de cuadrícula de entrada y genera el resultado como un ráster de cuadrícula.
# Name: CellStatistics_Ex_02.py
# Description: Calculates a per-cell statistic from multiple rasters
# 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
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "cost"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute CellStatistics
outCellStatistics = CellStatistics([inRaster01, inRaster02, inRaster03], "RANGE", "NODATA")
# Save the output
outCellStatistics.save("C:/sapyexamples/output/cellstats")
Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst