| Étiquette | Explication | Type de données |
Bandes 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.
| Boolean |
Calculer l’histogramme (Facultatif) | Indique si les statistiques d’histogramme seront calculées.
Lorsque ce paramètre est coché, les paramètres Nombre de groupes d’histogramme, Table d’histogramme en sortie et Nom de l’histogramme en sortie sont activés pour des options supplémentaires. | 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 toutes les bandes 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 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 Contenu sous Tables autonomes. Pour qu’un diagramme de type histogramme en sortie puisse être créé, la valeur du paramètre Table d’histogramme en sortie doit être spécifiée. | String |
Disponible avec une licence Spatial Analyst.
Synthèse
Calcule les statistiques pour un ensemble de canaux raster.
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 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 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 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 Tables autonomes dans la fenêtre Contenu. Reportez-vous à la rubrique Utiliser des tables autonomes dans les cartes pour en savoir plus.
Paramètres
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.
| Boolean |
compute_histogram (Facultatif) | Indique si les statistiques d’histogramme seront calculées.
Lorsque ce paramètre est défini sur COMPUTE_HISTOGRAM, les paramètres 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. | 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 toutes les bandes 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
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")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"
# Execute BandCollectionStats
BandCollectionStats([inRasterBand1, inRasterBand2], outStatFile, "DETAILED", "COMPUTE_HISTOGRAM", "256", outHistTable)Environnements
Informations de licence
- Basic: Nécessite Spatial Analyst
- Standard: Nécessite Spatial Analyst
- Advanced: Nécessite Spatial Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?