Estadísticas de colección de bandas (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 colección de bandas
Uso
-
Las bandas ráster deben tener una intersección común. Si no hay ninguna, ocurre 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.
-
La configuración predeterminada del parámetro de Calcular matrices (que es BRIEF en las secuencias de comando y está desmarcado en el cuadro de diálogo de la herramienta) es sólo para calcular el valor mínimo, máximo, medio y la desviación estándar de las bandas del ráster de entrada. Para calcular estas estadísticas y también las matrices de covarianza y correlación, establezca el parámetro en DETAILED en la secuencia de comandos o márquelo en el cuadro de diálogo de la herramienta. 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
junto a Bandas de ráster de entrada, abra el ráster y, a continuación, seleccione las bandas deseadas. - Si el ráster multibanda es una capa en la Tabla de contenido, puede utilizar la herramienta Crear capa ráster para crear una nueva capa multibanda que contiene solo 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.
- Si utiliza el cuadro de diálogo de la herramienta, navegue hasta el ráster multibanda utilizando el botón
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_raster_bands [in_raster_band,...] |
Bandas del ráster de entrada. | Raster Layer |
out_stat_file |
El archivo ASCII de salida que contiene las estadísticas. Se requiere una extensión .txt. | File |
compute_matrices (Opcional) |
Especifica si se calculan matrices de covarianza y correlación.
| Boolean |
Ejemplo de código
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")
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")