Statistiques de groupe de canaux (Outils Spatial Analyst)

Résumé

Calcule les statistiques pour un ensemble de canaux raster.

En savoir plus sur le fonctionnement de l’outil Statistiques de groupe de canaux

Utilisation

Lorsqu’un raster multicanal est spécifié comme l’un des Input raster bands (Canaux raster en entrée) (in_raster_bands dans Python), tous les canaux sont utilisés.

Pour traiter une sélection de canaux à partir d’un raster multicanal, vous pouvez créer en premier un jeu de données raster composé de ces canaux spécifiques à l’aide de l’outil Canaux composites puis utiliser le résultat dans la liste Input raster bands (Canaux raster en entrée) (in_raster_bands dans Python).
Les canaux raster doivent avoir une intersection commune. En l’absence d’une telle intersection, une erreur survient et aucune sortie n’est créée.
Si l’étendue n’est pas la même pour tous les canaux raster, les statistiques seront calculées selon l’étendue spatiale commune à tous les canaux raster en entrée. La taille de cellule correspondra à celle du maximum de rasters en entrée.
Pour le paramètre Compute covariance and correlation matrices (Calculer les matrices de covariance et de corrélation), le paramètre non coché par défaut (BRIEF pour écrire les scripts) indique que seuls les valeurs minimum, maximum, moyenne et l’écart type des canaux raster en entrée seront calculés. Pour calculer les matrices de covariance et de corrélation en plus de ces statistiques, cochez ce paramètre dans la boîte de dialogue de l’outil (ou utilisez DETAILED dans les scripts).

Les matrices de covariances présente les variances de tous les canaux raster le long de la diagonale allant du haut à gauche au bas à droite et les covariances entre tous les canaux raster dans les entrées restantes. La matrice de corrélation fournit les coefficients de corrélation entre chaque combinaison de deux canaux en entrée.
Dans le calcul de la matrice de covariance, la valeur moyenne du canal est utilisée pour les cellules en entrée dont la valeur est NoData.
Lorsque le paramètre Compute histogram (Calculer l’histogramme) est coché, les statistiques d’histogramme sont ajoutées dans le fichier de statistiques en sortie. En option, une table d’histogramme en sortie et un diagramme de type histogramme en sortie peuvent être créés, s’ils sont spécifiés.
Dans la table d’histogramme en sortie, les champs l<n>_count enregistrent le nombre de cellules de la couche <n> situées dans un groupe particulier. Les champs l<n>_percent enregistrent le pourcentage des cellules indiquées dans le champ de nombre par rapport au nombre total de cellules de la couche <n> dans la zone d’analyse.
Les statistiques sont écrites dans le fichier en sortie au format CSV (valeurs séparées par des virgules) ou Markdown. L’extension de la sortie doit être .txt, .md, .csv ou .asc.
Toutes les statistiques calculées par cet outil seront affichées dans la fenêtre Geoprocessing history (Historique de géotraitement), sauf l’histogramme. S’ils ont été créés, la table d’histogramme et le diagramme de type histogramme apparaissent dans Standalone Tables (Tables autonomes) dans la fenêtre Contents (Contenu). Reportez-vous à la rubrique Utiliser des tables autonomes dans les cartes pour en savoir plus.

Etiqueter	Explication	Type de données
Canaux raster en entrée	Canaux raster en entrée. Ils peuvent être de type entier ou à virgule flottante.	Raster Layer
Fichier de statistiques en sortie	Fichier texte ou Markdown en sortie contenant les statistiques. Une extension `.txt`, `.md`, `.csv` ou `.asc` est requise. La valeur par défaut est `.txt`. Le fichier de statistiques en sortie utilise le format CSV, sauf si l’extension `.md` est spécifiée. Dans ce cas, le fichier en sortie est au format Markdown.	File
Calculer les matrices de covariance et de corrélation (Facultatif)	Indique si les matrices de covariance et de corrélation seront calculées. Activé—Lorsque ce paramètre n’est pas activé, les mesures statistiques de base sont calculées ainsi que les matrices de covariance et de corrélation. Décoché—Seules les mesures statistiques de base (minimum, maximum, moyenne et écart type) sont calculées pour chaque couche. Il s’agit de l’option par défaut.	Boolean
Calculer l’histogramme (Facultatif)	Indique si les statistiques d’histogramme seront calculées. Lorsque ce paramètre est activé, les paramètres Number of Histogram Bins (Nombre de groupes d’histogramme), Output Histogram Table (Table d’histogramme en sortie) et Output Histogram Name (Nom de l’histogramme en sortie) sont pris en charge. Lorsque ce paramètre n’est pas activé, ces autres paramètres ne sont pas pris en charge. Activé—Les statistiques d’histogramme seront calculées. Décoché—Les statistiques d’histogramme ne seront pas calculées. Il s’agit de l’option par défaut.	Boolean
Nombre de groupes d’histogramme (Facultatif)	Spécifie le nombre de groupes d’histogramme à utiliser dans le calcul de l’histogramme. La valeur par défaut est 256. La valeur minimale autorisée est 1. La valeur maximale autorisée est 4096. La valeur de ce paramètre doit être définie en fonction des données en entrée et de l’application d’analyse.	Long
Table d’histogramme en sortie (Facultatif)	La table en sortie contiendra les statistiques d’histogramme pour tous les canaux en entrée. Le format de la table est déterminé par l’emplacement et le chemin d’accès en sortie. Par défaut, la sortie est une table de géodatabase dans un espace de travail de géodatabase et une table dBASE (fichier `.dbf`) dans un espace de travail de fichier. Pour qu’une table d’histogramme en sortie puisse être créée, le paramètre Compute histogram (Calculer l’histogramme) doit être coché.	Table
Nom de l’histogramme en sortie (Facultatif)	Nom de l’histogramme en sortie à afficher. L’histogramme apparaît dans la fenêtre Contents (Contenu) sous Standalone Tables (Tables autonomes). Pour qu’un diagramme de type histogramme en sortie puisse être créé, la valeur du paramètre Output Histogram Table (Table d’histogramme en sortie) doit être spécifiée.	String

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

Nom	Explication	Type de données
in_raster_bands [in_raster_band,...]	Canaux raster en entrée. Ils peuvent être de type entier ou à virgule flottante.	Raster Layer
out_stat_file	Fichier texte ou Markdown en sortie contenant les statistiques. Une extension `.txt`, `.md`, `.csv` ou `.asc` est requise. La valeur par défaut est `.txt`. Le fichier de statistiques en sortie utilise le format CSV, sauf si l’extension `.md` est spécifiée. Dans ce cas, le fichier en sortie est au format Markdown.	File
compute_matrices (Facultatif)	Indique si les matrices de covariance et de corrélation seront calculées. `DETAILED`—En plus des mesures statistiques de base calculées avec l’option `BRIEF`, les matrices de covariance et de corrélation seront également calculées. `BRIEF`—Seules les mesures statistiques de base (minimum, maximum, moyenne et écart type) sont calculées pour chaque couche. Il s’agit de l’option par défaut.	Boolean
compute_histogram (Facultatif)	Indique si les statistiques d’histogramme seront calculées. Lorsque ce paramètre est défini sur , les paramètres `COMPUTE_HISTOGRAM`, `number_bins`, `out_histogram_table` et `out_histogram` sont pris en charge. Lorsque ce paramètre est défini sur `NO_HISTOGRAM`, ces autres paramètres ne sont pas pris en charge. `COMPUTE_HISTOGRAM`—Les statistiques d’histogramme seront calculées. `NO_HISTOGRAM`—Les statistiques d’histogramme ne seront pas calculées. Il s’agit de l’option par défaut.	Boolean
number_bins (Facultatif)	Spécifie le nombre de groupes d’histogramme à utiliser dans le calcul de l’histogramme. La valeur par défaut est 256. La valeur minimale autorisée est 1. La valeur maximale autorisée est 4096. La valeur de ce paramètre doit être définie en fonction des données en entrée et de l’application d’analyse.	Long
out_histogram_table (Facultatif)	La table en sortie contiendra les statistiques d’histogramme pour tous les canaux en entrée. Le format de la table est déterminé par l’emplacement et le chemin d’accès en sortie. Par défaut, la sortie est une table de géodatabase dans un espace de travail de géodatabase et une table dBASE (fichier `.dbf`) dans un espace de travail de fichier. Pour qu’une table d’histogramme en sortie puisse être créée, le paramètre `compute_histogram` doit être défini sur `COMPUTE_HISTOGRAM`.	Table
out_histogram (Facultatif)	Nom de l’histogramme en sortie à afficher. Pour qu’un diagramme de type histogramme en sortie puisse être créé, la valeur du paramètre `out_histogram_table` doit être spécifiée.	String

Exemple de code

BandCollectionStats exemple 1 (fenêtre Python)

Cet exemple calcule les statistiques pour un ensemble de canaux raster.

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")

BandCollectionStats exemple 2 (script autonome)

Cet exemple calcule les statistiques pour un ensemble de canaux raster.

# 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"

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

Environnements

Taille de cellule, Cell Size Projection Method (Méthode de projection de la taille de cellule), Espace de travail courant, Etendue, Transformations géographiques, Masque, Système de coordonnées en sortie, Facteur de traitement parallèle, Espace de travail temporaire, Raster de capture

Informations de licence