Statistiques de groupe de canaux (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Calcule les statistiques pour un ensemble de canaux raster.

En savoir plus sur le fonctionnement de l’outil Band Collection Statistics (Statistiques de groupe de canaux)

Utilisation

• Lorsqu’un raster multicanal est spécifié comme l’un des canaux raster en entrée (Input raster bands) (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 et utilisez le résultat dans la liste des canaux raster en entrée (Input raster bands) (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 cette option dans la boîte de dialogue de l’outil (ou utilisez DETAILED pour écrire 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.

• Les statistiques sont écrites dans le fichier en sortie au format de texte ASCII. L’extension de la sortie doit être .txt.

Paramètres

Boîte de dialogue

Étiquette	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 ASCII en sortie contenant les statistiques. L’extension .txt est obligatoire.	File
Calculer les matrices de covariance et de corrélation (Facultatif)	Indique si les matrices de covariance et de corrélation sont calculées. Non 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. Coché : en plus des statistiques standard, les matrices de covariance et de corrélation sont également déterminées.	Boolean

Python

BandCollectionStats(in_raster_bands, out_stat_file, {compute_matrices})

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 ASCII en sortie contenant les statistiques. L’extension .txt est obligatoire.	File
compute_matrices (Facultatif)	Indique si les matrices de covariance et de corrélation sont 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. DETAILED—En plus des statistiques standard, les matrices de covariance et de corrélation sont également déterminées.	Boolean

Exemple de code

Exemple 1 d’utilisation de l’outil BandCollectionStatistics (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")

Exemple 2 d’utilisation de l’outil BandCollectionStatistics (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"

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

Environnements

Espace de travail courant, Espace de travail temporaire