Estadísticas focalizadas (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
 |
OutRas = FocalStatistics(InRas1, NbrRectangle(3,3,MAP), "SUM", "") |
Uso
-
Si el ráster de entrada es de tipo punto flotante, sólo se encontrarán disponibles las estadísticas Media, Máximo, Mínimo, Rango, DTP y Suma; las estadísticas Mayoría, Minoría, Mediana, y Diversidad 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.
-
solo 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 calculos está marcada, siempre que al menos una celda dentro de la vecindad tenga un valor válido.
Sintaxis
| Parámetro | Explicación | Tipo 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 Vecindad indica la forma del área alrededor de cada celda utilizada para calcular la estadística. Los diferentes tipos de vecindad disponible son NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge, NbrIrregular, y NbrWeight. A continuación, se presentan las formas de vecindad:
El parámetro {CELL | MAP} define las unidades de distancia como unidades de celda o unidades de mapa. La vecindad predeterminada es un NbrRectangle cuadrado de ancho y altura de 3 celdas. | Neighborhood |
statistics_type (Opcional) |
El tipo de estadística que se calculará.
El tipo de estadísticas predeterminado es MEAN. | 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 estadísticas focalizadas de salida. | Raster |
Ejemplo de código
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")
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")