Estadísticas de celdas (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

OutRas = CellStatistics([InRas1, InRas2, InRas3], "SUM", "DATA")

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 STD, los valores de la celda de salida serán todos de 0 y, para Variedad, 1.

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. MEAN — Calcula el valor medio (promedio) de las entradas. MAJORITY — Determina la mayoría (valor que se produce con más frecuencia) de las entradas. MAXIMUM — Determina el máximo (valor más grande) de las entradas. MEDIAN — Calcula la mediana de las entradas. MINIMUM — Determina el mínimo (valor más pequeño) de las entradas. MINORITY — Determina la minoría (valor que se produce con menos frecuencia) de las entradas. RANGE — Calcula el rango (diferencia entre los valores más grande y más pequeño) de las entradas. STD — Calcula la desviación estándar de las entradas. SUM — Calcula la suma (total de todos los valores) de las entradas. VARIETY — Calcula la variedad (la cantidad de valores únicos) de las entradas.	String
ignore_nodata (Opcional)	Indica si los valores NoData serán ignorados por el cálculo de estadísticas. DATA — solo se utilizarán las celdas que poseen valores de datos para determinar el valor estadístico.Si existe un valor NoData en alguna ubicación, éste se ignorará. Solo se utilizarán los valores de datos para determinar la salida. NODATA — Se utilizarán todas las celdas de entrada de cada ubicación, incluso aquellas con un valor NoData, para determinar las estadísticas.	Boolean

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	El ráster de salida. El valor se determina mediante la aplicación del tipo de estadística especificado en los rásteres de entrada.	Raster

Ejemplo 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 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

Tamaño de celda, Espacio de trabajo actual, Máscara, Sistema de coordenadas de salida, Extensión, Espacio de trabajo temporal, Alinear ráster

Información sobre licencias

ArcGIS for Desktop Basic: Requiere Spatial Analyst

ArcGIS for Desktop Standard: Requiere Spatial Analyst

ArcGIS for Desktop Advanced: Requiere Spatial Analyst