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 funciona Estadísticas de conjunto de bandas
Uso
Cuando se especifica un ráster multibanda como una de las Bandas del ráster de entrada (in_raster_bands en Python), se utilizarán todas las bandas.
Para procesar una selección de bandas a partir de un ráster multibanda, puede crear primero un dataset ráster nuevo formado por esas bandas concretas con la herramienta Bandas compuestas y utilizar el resultado en la lista de Bandas del ráster de entrada (in_raster_bands en Python).
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 de ráster.
En el parámetro Calcular matrices de covarianza y correlación, la configuración desactivada predeterminada (BRIEF en scripts) 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 scripts).
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.
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 |
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 Spatial Analyst
- ArcGIS Desktop Standard: Requiere Spatial Analyst
- ArcGIS Desktop Advanced: Requiere Spatial Analyst