Statistiques de groupe de canaux (Spatial Analyst)
Récapitulatif
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
-
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.
-
Le paramètre de calcul des matrices par défaut (BRIEF dans le script, désactivé dans la boîte de dialogue de l'outil) sert uniquement à calculer le minimum, le maximum, la moyenne et l'écart-type des canaux raster en entrée. Pour calculer ces statistiques, ainsi que la covariance et les matrices de corrélation, associez le paramètre à la valeur DETAILED dans le script (ou sélectionnez-le dans la boîte de dialogue de l'outil). Une matrice de covariance présente les variances de tous les canaux raster le long de la diagonale entre le côté gauche supérieure 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.
-
Si l'entrée est une couche créée à partir d'un raster multicanal comportant plus de trois canaux, l'opération considérera tous les canaux associés au jeu de données source, et non pas seulement les trois canaux qui ont été chargés (symbolisés) par la couche.
Vous pouvez employer plusieurs méthodes pour spécifier un sous-ensemble de canaux à partir d'un raster multicanal en vue de l'utiliser en entrée dans l'outil.
- Si vous utilisez la boîte de dialogue de l'outil, accédez au raster multicanal en cliquant sur
le bouton Parcourir qui se trouve à côté de l'option Canaux raster en entrée, ouvrez le raster et sélectionnez les canaux de votre choix. - Si le raster multicanal est une couche dans la table des matières, vous pouvez utiliser l'outil Générer une couche raster pour créer une couche multicanal contenant uniquement les canaux souhaités.
- Vous pouvez également faire appel à l'option Canaux composites pour créer un jeu de données contenant uniquement les canaux souhaités et utiliser le jeu de données résultant en entrée dans l'outil.
- Dans Python, vous pouvez spécifier les canaux de votre choix sous forme de liste directement dans le paramètre de l'outil.
- Si vous utilisez la boîte de dialogue de l'outil, accédez au raster multicanal en cliquant sur
Syntaxe
| Paramètre | Explication | Type de données |
in_raster_bands [in_raster_band,...] |
Canaux raster en entrée. | 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.
| Boolean |
Exemple de code
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")
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")