Estadísticas focalizadas (Image Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image 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 zonales
OutRas = FocalStatistics(InRas1, NbrRectangle(3,3,MAP), "SUM", "")

Uso

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

  • Cuando se especifica una vecindad circular, con forma de anillo o con forma de cuña, 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 Más información sobre cómo funcionan las Estadísticas focalizadas para obtener información sobre la creación y el uso de archivos de kernel.

  • El tipo Vecindad se puede establecer en Peso solo para las estadísticas de tipo Valor medio, Desviación estándar y Suma.

  • Las celdas NoData de entrada pueden recibir un valor en la salida si el parámetro Ignorar los NoData en los cálculos se ha activado, siempre que haya al menos una celda de la vecindad que tenga un valor válido.

Sintaxis

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

El ráster en que se calcularán las estadísticas focalizadas para cada celda de entrada.

Raster Layer
neighborhood
(Opcional)

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

Los 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 cuadrado NbrRectangle con un ancho y una altura de tres celdas.

Neighborhood
statistics_type
(Opcional)

Especifica el tipo de estadística que se calculará.

  • MEANCalcula la media (valor medio) de las celdas en la vecindad.
  • MAJORITYCalcula la mayoría (valor que se produce con más frecuencia) de las celdas en la vecindad.
  • MAXIMUMCalcula el máximo (mayor valor) de las celdas en la vecindad.
  • MEDIANCalcula la mediana de las celdas en la vecindad.
  • MINIMUMCalcula el mínimo (valor inferior) de las celdas en la vecindad.
  • MINORITYCalcula la minoría (valor que se produce con menor frecuencia) de las celdas en la vecindad.
  • PERCENTILECalcula un percentil de las celdas en la vecindad. El 90.º percentil se calcula de forma predeterminada. Puede especificar otros valores (del 0 al 100) con el parámetro Valor de percentil.
  • RANGECalcula el rango (diferencia entre los valores mayor e inferior) de las celdas en la vecindad.
  • STDCalcula la desviación estándar de las celdas en la vecindad.
  • SUMCalcula la suma (total de todos los valores) de las celdas en la vecindad.
  • VARIETYCalcula la variedad (el número de valores únicos) de las celdas en la vecindad.

El tipo de estadísticas predeterminado es Valor medio.

Si el ráster de entrada es un entero, están disponibles todos los tipos de estadísticas. Si el ráster de entrada es de punto flotante, solo están disponibles los tipos de estadísticas Valor medio, Máximo, Mediana, Mínimo, Percentil, Rango, Desviación estándar y Suma.

String
ignore_nodata
(Opcional)

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

  • DATASi 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. Significa que, si el valor de la celda de procesamiento es NoData, la celda de procesamiento puede recibir un valor en el ráster de salida si esta opción está seleccionada, siempre que haya al menos una celda en la vecindad que tenga un valor válido. Esta es la opción predeterminada.
  • NODATASi alguna 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
percentile_value
(Opcional)

El percentil que se va a calcular. El valor predeterminado es 90, para el 90.º percentil.

Los valores pueden variar de 0 a 100. El 0.º percentil equivale en esencia a la estadística Mínimo, mientras que el 100.º percentil equivale a la estadística Máximo. Un valor de 50 generará en esencia el mismo resultado que la estadística Mediana.

Esta opción solo se admite si el parámetro statistics_type está establecido en percentile. Si se ha especificado cualquier otro tipo de estadísticas, este parámetro se omite.

Double

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 del ráster de entrada.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/data"
outFocalStat = FocalStatistics("elevation", NbrAnnulus(5, 10, "CELL"), 
                               "MINORITY", "NODATA")
outFocalStat.save("C:/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: Image Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inRaster = "elevation"
neighborhood = NbrRectangle(10, 10, "CELL")

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

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

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

Información de licenciamiento

  • Basic: Requiere Image Analyst or Spatial Analyst
  • Standard: Requiere Image Analyst or Spatial Analyst
  • Advanced: Requiere Image Analyst or Spatial Analyst

Temas relacionados