Ayuda

Estadísticas de celdas

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

Estadísticas de celda: Ilustración de la suma
OutRas = CellStatistics([InRas1, InRas2, InRas3], "SUM", "NODATA")

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.

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

Sintaxis

CellStatistics (in_rasters_or_constants, {statistics_type}, {ignore_nodata})
ParámetroExplicació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.

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.

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.

  • 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. Esta es la opción predeterminada.
  • 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

NombreExplicaciónTipo 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

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

Temas relacionados

¿Algún comentario sobre este tema?