Estadísticas de conjunto de bandas (Spatial Analyst)—ArcGIS Pro

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. El tamaño de celda será el máximo de los rásteres de entrada.
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 este parámetro 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.
Cuando el parámetro Calcular histograma esté activado, las estadísticas del histograma se agregarán al archivo de estadísticas de salida. También se puede crear una tabla de histograma de salida o un gráfico de histograma de salida si se especifica.
En la tabla de histograma de salida, los campos l<n>_count registran la cantidad de celdas de la capa <n> que se encuentran en un bin particular. Los campos l<n>_percent registran el porcentaje de celdas reportadas en el campo de cantidad entre el número total de celdas de la capa <n> del área de análisis.
Las estadísticas se escriben en el archivo de salida en formato de valores separados por comas (CSV) o en formato Markdown. La extensión para la salida debe ser .txt, .md, .csv o .asc.
Todas las estadísticas calculadas por esta herramienta se mostrarán en el panel Historial de geoprocesamiento, excepto el histograma. Si se crea, la tabla de histograma y el gráfico aparecerán en Tablas independientes en el panel Contenido. Consulte Trabajar con tablas independientes en mapas para obtener más información.

Parámetros

Etiqueta	Explicación	Tipo de datos
Bandas de ráster de entrada	Bandas del ráster de entrada. Pueden ser de tipo entero o de punto flotante.	Raster Layer
Archivo de estadísticas de salida	Texto o archivo markdown de salida que contiene las estadísticas. Se requiere una extensión .txt, .md, .csv o .asc. El valor predeterminado es .txt. El archivo de estadísticas de salida utiliza un formato CSV, excepto cuando se especifica una extensión .md. En este caso, el archivo de salida estará en formato markdown.	File
Calcular matrices de covarianza y correlación (Opcional)	Especifica si se calcularán matrices de covarianza y correlación. Desactivado: 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. Activado: además de las medidas estadísticas básicas, también se calcularán las matrices de covarianza y correlación.	Boolean
Calcular histograma (Opcional)	Especifica si se calcularán estadísticas de histograma. Desactivado: no se calcularán estadísticas de histograma. Esta es la opción predeterminada. Activado: se calcularán estadísticas de histograma. Cuando se active este parámetro, se habilitarán los parámetros Número de bins de histograma, Tabla de histograma de salida y Nombre de histograma de salida correspondientes a opciones adicionales.	Boolean
Número de bins de histograma (Opcional)	Especifica el número de bins de histograma que se utilizará en el cálculo del histograma. El valor predeterminado es 256. El valor mínimo permitido es 1. El valor máximo permitido es 4096. El valor de este parámetro debería configurarse con arreglo a los datos de entrada y la aplicación de análisis.	Long
Tabla de histograma de salida (Opcional)	Tabla de salida que contendrá las estadísticas de histograma de todas las bandas de entrada. El formato de la tabla está determinado por la ubicación y la ruta de salida. De forma predeterminada, la salida será una tabla de geodatabase en un espacio de trabajo de geodatabase y una tabla dBASE (archivo .dbf) en un espacio de trabajo de archivo. Para crear una tabla de histograma de salida, el parámetro Calcular histograma debe estar activado.	Table
Nombre de histograma de salida (Opcional)	Nombre del histograma de salida que se va a mostrar. El histograma figurará en el panel Contenido en Tablas independientes. Para crear un gráfico de histograma de salida, debe especificarse el parámetro Tabla de histograma de salida.	String

BandCollectionStats(in_raster_bands, out_stat_file, {compute_matrices}, {compute_histogram}, {number_bins}, {out_histogram_table}, {out_histogram})

Nombre	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	Texto o archivo markdown de salida que contiene las estadísticas. Se requiere una extensión .txt, .md, .csv o .asc. El valor predeterminado es .txt. El archivo de estadísticas de salida utiliza un formato CSV, excepto cuando se especifica una extensión .md. En este caso, el archivo de salida estará en formato markdown.	File
compute_matrices (Opcional)	Especifica si se calcularán 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 de las medidas estadísticas básicas calculadas con la opción BRIEF, también se calcularán las matrices de covarianza y correlación.	Boolean
compute_histogram (Opcional)	Especifica si se calcularán estadísticas de histograma. NO_HISTOGRAM—No se calcularán estadísticas de histograma. Esta es la opción predeterminada. COMPUTE_HISTOGRAM—Se calcularán estadísticas de histograma. Cuando este parámetro se configure en COMPUTE_HISTOGRAM, se admitirán los parámetros number_bins, out_histogram_table y out_histogram. Cuando este parámetro se configure en NO_HISTOGRAM, los demás parámetros no se admitirán.	Boolean
number_bins (Opcional)	Especifica el número de bins de histograma que se utilizará en el cálculo del histograma. El valor predeterminado es 256. El valor mínimo permitido es 1. El valor máximo permitido es 4096. El valor de este parámetro debería configurarse con arreglo a los datos de entrada y la aplicación de análisis.	Long
out_histogram_table (Opcional)	Tabla de salida que contendrá las estadísticas de histograma de todas las bandas de entrada. El formato de la tabla está determinado por la ubicación y la ruta de salida. De forma predeterminada, la salida será una tabla de geodatabase en un espacio de trabajo de geodatabase y una tabla dBASE (archivo .dbf) en un espacio de trabajo de archivo. Para crear una tabla de histograma de salida, el parámetro compute_histogram debe estar configurado en COMPUTE_HISTOGRAM.	Table
out_histogram (Opcional)	Nombre del histograma de salida que se va a mostrar. Para crear un gráfico de histograma de salida, debe especificarse el parámetro out_histogram_table.	String

Muestra de código

Ejemplo 1 de BandCollectionStats (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", "COMPUTE_HISTOGRAM", "256", "c:/sapyexamples/output/outtable01.dbf", "histogram01")

Ejemplo 2 de BandCollectionStats (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"
outHistTable = "C:/sapyexamples/output/output.gdb/outtable01"

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

Entornos

Tamaño de celda, Método de proyección de tamaño de celda, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Máscara, Sistema de coordenadas de salida, Factor de procesamiento en paralelo, Espacio de trabajo temporal, Alinear ráster

Información de licenciamiento

Basic: Requiere Spatial Analyst
Standard: Requiere Spatial Analyst
Advanced: Requiere Spatial Analyst

Temas relacionados

¿Algún comentario sobre este tema?