ArcMap

Estadísticas de conjunto de bandas

Disponible con una licencia de Spatial Analyst.

Resumen

Calcula las estadísticas para un conjunto de bandas de ráster.

Más información sobre cómo funcionan las Estadísticas de conjunto de bandas

Uso

  • Las bandas ráster deben tener una intersección común. Si no hay ninguna, se produce un error y no se crea ninguna salida.

  • Si las extensiones de las bandas de ráster no son iguales, las estadísticas se calcularán en la extensión espacial común de todas las bandas del ráster de entrada. Por defecto, el tamaño de celda será el de los rásteres de entrada máximos; de lo contrario, dependerá de la configuración del entorno de Análisis ráster.

  • En el parámetro Calcular matrices de covarianza y correlación, la configuración desactivada predeterminada (BRIEF en secuencias de comandos) indica que solo se calcula el mínimo, el máximo, el valor medio y la desviación estándar de las bandas de ráster de entrada. Para calcular las matrices de covarianza y correlación además de estas estadísticas, active esta opción en el cuadro de diálogo de la herramienta (o utilice DETAILED en secuencias de comandos).

    Una matriz de covarianza presenta las varianzas de todas la bandas de ráster a lo largo de la diagonal, desde la parte superior izquierda hasta la parte inferior derecha, y las covarianzas entre todas las bandas de ráster en las entradas restantes. La matriz de correlación proporciona los coeficientes de correlación entre cada combinación de dos bandas de entrada.

  • En el cálculo de la matriz de covarianza, el valor de la media de la banda se usa para cualquier celda de entrad que sea NoData.

  • Las estadísticas se escriben en el archivo de salida en formato de texto ASCII. La extensión para la salida debe ser .txt.

  • Si la entrada es una capa creada desde un ráster multibanda con más de tres bandas, la operación considerará todas las bandas asociadas con el dataset de origen, no sólo las tres bandas que fueron cargadas (simbolizadas) por la capa.

  • Hay varias maneras de especificar un subconjunto de bandas a partir de un ráster multibanda para utilizar como entrada en la herramienta.

    • Si utiliza el cuadro de diálogo de la herramienta, navegue hasta el ráster multibanda utilizando el botón de examinar Examinar junto a Bandas de ráster de entrada, abra el ráster y, a continuación, seleccione las bandas que desee.
    • Si el ráster multibanda es una capa de la tabla de contenido, puede usar la herramienta Crear capa ráster para crear una nueva capa multibanda que solo contenga las bandas deseadas.
    • También puede crear un nuevo dataset que contiene solo las bandas deseadas con Bandas compuestas y utilizar el dataset resultante como entrada para la herramienta.
    • En Python, las bandas deseadas se pueden especificar directamente en el parámetro de herramienta como una lista.

Sintaxis

BandCollectionStats (in_raster_bands, out_stat_file, {compute_matrices})
ParámetroExplicaciónTipo de datos
in_raster_bands
[in_raster_band,...]

Bandas del ráster de entrada.

Pueden ser de tipo entero o de punto flotante.

Raster Layer
out_stat_file

El archivo ASCII de salida que contiene las estadísticas.

Se requiere la extensión .txt.

File
compute_matrices
(Opcional)

Especifica si se calculan matrices de covarianza y correlación.

  • BRIEF — Sólo se calcularán las medidas estadísticas básicas (el valor mínimo, máximo, medio y la desviación estándar) para cada capa. Esta es la opción predeterminada.
  • DETAILED — Además del cálculo de las estadísticas estándar con {BRIEF}, también se determinarán las matrices de covarianza y correlación.
Boolean

Muestra de código

Ejemplo 1 de BandCollectionStatistics (ventana de Python)

Este ejemplo calcula las estadísticas para un conjunto de bandas de ráster.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
BandCollectionStats("redlands", "c:/sapyexamples/output/redbandstats.txt", "BRIEF")
Ejemplo 2 de BandCollectionStatistics (secuencia de comandos independiente)

Este ejemplo calcula las estadísticas para un conjunto de bandas de ráster.

# Name: BandCollectionStats_Ex_02.py
# Description: Calculates the statistics for a set of raster bands.
# 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
inRasterBand1 = "sb/sbc1"
inRasterBand2 = "sb/sbc2"
outStatFile = "C:/sapyexamples/output/bandstatfile.txt"

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

# Execute BandCollectionStats
BandCollectionStats([inRasterBand1, inRasterBand2], outStatFile, "DETAILED")

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