Disponible con una licencia de Spatial Analyst.
Resumen
Divide la entrada en bloques no superpuestos y calcula las estadísticas de los valores dentro de cada bloque. El valor se asigna a todas las celdas de cada bloque en la salida.
Ilustración
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.
Si el ráster de entrada es de tipo de punto flotante, la salida será de tipo flotante para todos los tipos de estadísticas disponibles.
Si el ráster de entrada es un entero, la salida será un entero para la mayoría de los tipos de estadísticas. Para los tipos de estadísticas Valor medio y Desviación estándar, la salida siempre será de punto flotante.
Cuando se especifica una vecindad circular, con forma de anillo o con forma de porción de círculo, según el tamaño de la vecindad, es probable que para el cálculo no se tengan en cuenta las celdas que no son perpendiculares al eje x o y. Sin embargo, estas ubicaciones de celda recibirán el valor resultante de los cálculos de la vecindad porque caen dentro del rectángulo mínimo de delimitación (o el bloque de salida) de estos tipos de vecindad circular.
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 de bloques para obtener información sobre la creación y el uso de archivos kernel.
Para el tipo de estadística mediana, si la cantidad de celdas en el bloque es impar, se clasifican los valores y se toma el valor medio como la mediana, y es un entero. Si la cantidad de celdas en el bloque es par, se clasifican los valores y se promedian los dos valores medios al entero más próximo.
Para el tipo de estadística de mayoría, a las celdas que no poseen un valor de mayoría simple (es decir, dos o más valores dentro de un bloque tienen la cantidad máxima de celdas con ese valor) se les asigna NoData. Para el tipo de estadística de minoría, a las celdas que no poseen un valor de minoría simple también se les asigna NoData.
Para el tipo de estadística de valor medio, minoría, desviación estándar o suma, el tipo Vecindad se puede establecer en Peso.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
BlockStatistics (in_raster, {neighborhood}, {statistics_type}, {ignore_nodata})
Parámetro | Explicación | Tipo de datos |
in_raster | El ráster donde se realizan los cálculos de estadísticas de bloques. | 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:
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á.
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 de bloques de salida. | Raster |
Muestra de código
Ejemplo 1 de BlockStatistics (ventana de Python)
En este ejemplo se calcula el valor de celda mínimo dentro de cada vecindad de anillo no superpuesto en el ráster de la cuadrícula de salida.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
nbr = NbrAnnulus(1, 3, "MAP")
outBlockStat = BlockStatistics("block", nbr, "MINIMUM", "")
outBlockStat.save("C:/sapyexamples/output/blockstat")
Ejemplo 2 de BlockStatistics (secuencia de comandos independiente)
En este ejemplo se calcula el valor de celda mínimo dentro de cada vecindad de anillo no superpuesto en el ráster de la cuadrícula de salida.
# Name: BlockStatistics_Ex_02.py
# Description: Calculates statistics for a nonoverlapping
# 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 = "block"
nbr = NbrAnnulus(1, 3, "MAP")
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute BlockStatistics
outBlockStat = BlockStatistics(inRaster, nbr, "MINIMUM", "NODATA")
# Save the output
outBlockStat.save("C:/sapyexamples/output/blockstat")
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