Estadísticas de bloque (ArcGIS 10.1 Spatial Analyst)

Nivel de licencia:BasicStandardAdvanced

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.

Más información sobre cómo funciona Estadísticas de bloques

Ilustración

Block Statistics with Maximum option illustration
OutRas = BlockStatistics(InRas1, NbrRectangle(3,3,MAP), "MAXIMUM", "")

Uso

Sintaxis

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

El ráster donde se realizan los cálculos de estadísticas en bloque.

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:

  • 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 de ancho y 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.

String
ignore_nodata
(Opcional)

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

  • DATOS Especifica que si existe un valor NoData dentro de una vecindad de bloque, 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 cada celda en el bloque correspondiente recibirá 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 de bloques de salida.

Raster

Ejemplo 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 GRID 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 GRID 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

Temas relacionados

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
5/10/2014