ArcMap

Estadísticas focalizadas

Disponible con una licencia de Spatial Analyst.

Resumen

Para cada ubicación de celda de entrada, calcula una estadística de los valores dentro de una vecindad especificada alrededor de ella.

Más información sobre cómo funcionan las Estadísticas focalizadas

Ilustración

Ilustración de Estadísticas focalizadas
OutRas = FocalStatistics(InRas1, NbrRectangle(3,3,MAP), "SUM", "")

Uso

  • Si el ráster de entrada es de tipo de punto flotante, solo se encontrarán disponibles las estadísticas Media, Máximo, Mínimo, Rango, Desviación estándar y Suma, mientras que las estadísticas Mayoría, Minoría, Mediana y Variedad no están permitidas. Si el ráster de entrada es de tipo entero, todos los tipos de estadísticas se encontrarán disponibles.

  • Cuando se especifica una vecindad circular, con forma de anillo o con forma de porción de círculo, es probable que para el cálculo no se tengan en cuenta algunas celdas diagonales externas, ya que la vecindad debe abarcar el centro de la celda.

  • Los tipos de Vecindad Irregular y Peso requieren que se especifique un Archivo kernel. Los archivos kernel deben tener una extensión de archivo .txt.

    Consulte las secciones Irregular y Peso de Cómo funciona Estadísticas focalizadas para obtener información sobre la creación y el uso de archivos kernel.

  • Sólo para los tipos de estadística de valor medio, desviación estándar o suma, el tipo Vecindad se puede establecer en Peso.

  • Las celdas NoData de entrada pueden recibir un valor en la salida si la opción Ignorar NoData en cálculos está activada, siempre que al menos una celda dentro de la vecindad tenga un valor válido.

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

Sintaxis

FocalStatistics (in_raster, {neighborhood}, {statistics_type}, {ignore_nodata})
ParámetroExplicaciónTipo de datos
in_raster

El ráster donde se realizan los cálculos de las estadísticas focalizadas.

Raster Layer
neighborhood
(Opcional)

La clase de Neighborhood indica la forma del área alrededor de cada celda utilizada para calcular la estadística.

Los diferentes tipos de vecindad disponibles son NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge, NbrIrregular, y NbrWeight.

A continuación, se presentan las formas de vecindad:

  • NbrAnnulus({innerRadius}, {outerRadius}, {units})
  • NbrCircle({radius}, {units}
  • NbrRectangle({width}, {height}, {units})
  • NbrWedge({radius}, {startAngle}, {endAngle}, {units})
  • NbrIrregular(inKernelFile)
  • NbrWeight(inKernelFile)

La vecindad predeterminada es un NbrRectangle cuadrado con un ancho y una altura de 3 celdas.

Neighborhood
statistics_type
(Opcional)

El tipo de estadística que se calculará.

  • MEAN — Calcula la media (valor medio) de las celdas en la vecindad.
  • MAJORITY — Calcula la mayoría (valor que se produce con más frecuencia) de las celdas en la vecindad.
  • MAXIMUM — Calcula el máximo (mayor valor) de las celdas en la vecindad.
  • MEDIAN — Calcula la mediana de las celdas en la vecindad.
  • MINIMUM — Calcula el mínimo (valor inferior) de las celdas en la vecindad.
  • MINORITY — Calcula la minoría (valor que se produce con menor frecuencia) de las celdas en la vecindad.
  • RANGE — Calcula el rango (diferencia entre los valores mayor e inferior) de las celdas en la vecindad.
  • STD — Calcula la desviación estándar de las celdas en la vecindad.
  • SUM — Calcula la suma (total de todos los valores) de las celdas en la vecindad.
  • VARIETY — Calcula la variedad (el número de valores únicos) de las celdas en la vecindad.

El tipo de estadísticas predeterminado es MEAN.

Si el ráster de entrada es de tipo de punto flotante, solo se encontrarán disponibles las estadísticas MEAN, MAXIMUM, MINIMUM, RANGE, STD y SUM.

String
ignore_nodata
(Opcional)

Indica si los valores NoData serán ignorados por el cálculo de estadísticas.

  • DATA — Especifica que si existe un valor NoData dentro de una vecindad, este se ignorará. Para determinar el valor de salida solo se utilizarán las celdas dentro de la vecindad que contengan valores de datos. Esta es la opción predeterminada.
  • NODATA —Especifica que si cualquier celda de una vecindad tiene el valor de NoData, la salida de la celda de procesamiento será NoData. Mediante esta opción, la presencia de un valor NoData implica que no hay información suficiente para determinar el valor estadístico de la vecindad.
Boolean

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de estadísticas focalizadas de salida.

Raster

Muestra de código

Ejemplo 1 de FocalStatistics (ventana de Python)

En este ejemplo se calcula el valor que ocurre con menor frecuencia en una vecindad con forma de anillo alrededor de cada celda en el ráster de entrada.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFocalStat = FocalStatistics("elevation", NbrAnnulus(5, 10, "CELL"), 
                               "MINORITY", "NODATA")
outFocalStat.save("C:/sapyexamples/output/focalstat01")
Ejemplo 2 de FocalStatistics (secuencia de comandos independiente)

En este ejemplo se determina el valor que ocurre con menor frecuencia en una vecindad de 10 por 10 alrededor de cada celda en el ráster de entrada.

# Name: FocalStatistics_Ex_02.py
# Description: Calculates a statistic on a raster over a specified
#    neighborhood.
# 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
inRaster = "elevation"
neighborhood = NbrRectangle(10, 10, "CELL")

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute FocalStatistics
outFocalStatistics = FocalStatistics(inRaster, neighborhood, "MINORITY",
                                     "")

# Save the output 
outFocalStatistics.save("C:/sapyexamples/output/focalstatout")

Entornos

Información sobre licencias

  • ArcGIS Desktop Basic: Requiere Análisis espacial
  • ArcGIS Desktop Standard: Requiere Análisis espacial
  • ArcGIS Desktop Advanced: Requiere Análisis espacial

Temas relacionados