Statistiques de groupe de canaux (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Résumé

Calcule les statistiques d'un jeu de canaux raster.

Pour 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 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 les étendues des canaux raster ne sont pas les mêmes, les statistiques seront calculées sur l’étendue spatiale commune à tous les canaux raster en entrée. Par défaut, la taille de cellule correspond au maximum des rasters en entrée. Sinon, elle est fonction des paramètres de l’analyseur raster.

  • Pour le paramètre Compute covariance and correlation matrices (Calculer les matrices de covariance et de corrélation), le paramètre non activé par défaut (BRIEF dans le script) indique que le minimum, le maximum, la moyenne et l’écart type des canaux raster en entrée uniquement 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 dans le script).

    Une matrice de covariance présente les variances de tous les canaux raster le long de la diagonale entre le côté gauche supérieur et le côté droit inférieur, ainsi que les covariances entre tous les canaux dans les autres entrées. 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 toutes cellules en entrée de valeur NoData.

  • Les statistiques sont enregistrées dans le fichier en sortie au format texte ASCII. La sortie doit avoir l’extension .txt.

Syntaxe

BandCollectionStats(in_raster_bands, out_stat_file, {compute_matrices})
ParamètreExplicationType 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 des 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 Outre les statistiques standard calculées avec {BRIEF}, les matrices de covariance et de corrélation sont également définies.
Boolean

Exemple de code

Premier exemple d'utilisation de l'outil BandCollectionStatistics (fenêtre Python)

Cet exemple décrit le calcul des statistiques d’un jeu 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")
Deuxième exemple d'utilisation de l'outil BatchCalculateStatistics (script autonome)

Cet exemple décrit le calcul des statistiques d’un jeu 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"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.checkOutExtension("Spatial")

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

Informations de licence

  • Basic: Requiert Spatial Analyst
  • Standard: Requiert Spatial Analyst
  • Advanced: Requiert Spatial Analyst

Rubriques connexes