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 solo las tres bandas 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 usa el cuadro de diálogo de la herramienta, vaya al ráster multibanda usando el botón Examinar
situado junto a Bandas del ráster de entrada, abra el ráster y 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.
- Si usa el cuadro de diálogo de la herramienta, vaya al ráster multibanda usando el botón Examinar
Sintaxis
BandCollectionStats (in_raster_bands, out_stat_file, {compute_matrices})| Parámetro | Explicación | Tipo 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.
| Boolean |
Ejemplo 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 for Desktop Basic: Requiere Spatial Analyst
- ArcGIS for Desktop Standard: Requiere Spatial Analyst
- ArcGIS for Desktop Advanced: Requiere Spatial Analyst