Calculer les statistiques par lots (Outils de gestion des données)

Résumé

Calcule les statistiques de plusieurs jeux de données raster.

Utilisation

Un pas d’échantillonnage contrôle la partie du raster qui est utilisée dans le calcul des statistiques. La valeur en entrée indique le pas d’échantillonnage horizontal ou vertical : la valeur 1 utilise chaque pixel et la valeur 2 utilise un pixel sur deux. Le pas d’échantillonnage peut uniquement s’étendre de la valeur 1 au nombre de colonnes/lignes du raster.
Le calcul des statistiques dans les formats Grille Esri et RADARSAT2 utilise toujours un pas d’échantillonnage de 1.
Les pas d’échantillonnage sont assez différents pour les jeux de données raster stockés dans une géodatabase fichier ou une géodatabase d’entreprise. Tout d’abord, si les pas d’échantillonnage x et y sont différents, c’est le pas le plus petit qui est utilisé. Ensuite, le pas d’échantillonnage est lié au niveau de pyramide le mieux adapté au pas choisi. Si la valeur du pas d’échantillonnage n’est pas égale au nombre de pixels dans une pyramide (par exemple, si le pas d’échantillonnage est 5 et que le niveau de pyramide le plus proche est 4 x 4 pixels, ce qui correspond au niveau 2), le logiciel arrondira à la baisse au niveau de pyramide suivant (dans ce cas, 2) et utilisera cette valeur comme pas d’échantillonnage.
Un pas d’échantillonnage n’est pas utilisé pour tous les formats de raster. Les formats de raster qui calculent les statistiques et utilisent le pas d’échantillonnage sont les suivants : TIFF, IMG, NITF, DTED, RAW, ADRG, CIB, CADRG, DIGEST, SIG, LAN, CIT, COT, ERMapper, ENVI DAT, BIL, BIP, BSQ et géodatabase.
L’option Ignore Values (Ignorer les valeurs) vous permet d’exclure une valeur spécifique du calcul des statistiques. Vous pouvez décider d’ignorer une valeur si elle est de type NoData ou si elle risque de fausser votre calcul.

Etiqueter	Explication	Type de données
Jeux de données de raster en entrée	Les jeux de données raster en entrée.	Raster Dataset
Pas d’échantillonnage X (Facultatif)	Nombre de pixels horizontaux entre échantillons. Un pas d’échantillonnage contrôle la partie du raster qui est utilisée dans le calcul des statistiques. La valeur en entrée indique le pas d’échantillonnage horizontal ou vertical : la valeur 1 utilise chaque pixel et la valeur 2 utilise un pixel sur deux. Le pas d’échantillonnage peut uniquement s’étendre de la valeur 1 au nombre de colonnes/lignes du raster. Cette valeur doit être supérieure à 0 et inférieure ou égale au nombre de colonnes du raster. La valeur par défaut est égale à 1 ou au dernier pas d’échantillonnage utilisé. Les pas d’échantillonnage sont différents pour les jeux de données raster stockés dans une géodatabase fichier ou une géodatabase d’entreprise. Tout d’abord, si les pas d’échantillonnage x et y sont différents, c’est le pas le plus petit qui est utilisé. Ensuite, le pas d’échantillonnage est lié au niveau de pyramide le mieux adapté au pas choisi. Si la valeur du pas d’échantillonnage est différente du nombre de pixels d’une structure pyramidale, le nombre est arrondi au niveau de pyramide suivant et ces statistiques sont utilisées.	Long
Pas d’échantillonnage Y (Facultatif)	Nombre de pixels verticaux entre les échantillons. Un pas d’échantillonnage contrôle la partie du raster qui est utilisée dans le calcul des statistiques. La valeur en entrée indique le pas d’échantillonnage horizontal ou vertical : la valeur 1 utilise chaque pixel et la valeur 2 utilise un pixel sur deux. Le pas d’échantillonnage peut uniquement s’étendre de la valeur 1 au nombre de colonnes/lignes du raster. Cette valeur doit être supérieure à 0 et inférieure ou égale au nombre de lignes du raster. La valeur par défaut est égale à 1 ou à la valeur du dernier pas d’échantillonnage y utilisé. Les pas d’échantillonnage sont différents pour les jeux de données raster stockés dans une géodatabase fichier ou une géodatabase d’entreprise. Tout d’abord, si les pas d’échantillonnage x et y sont différents, c’est le pas le plus petit qui est utilisé. Ensuite, le pas d’échantillonnage est lié au niveau de pyramide le mieux adapté au pas choisi. Si la valeur du pas d’échantillonnage est différente du nombre de pixels d’une structure pyramidale, le nombre est arrondi au niveau de pyramide suivant et ces statistiques sont utilisées.	Long
Valeurs non significatives (Facultatif)	Valeurs de pixel à ne pas inclure dans le calcul de statistiques. Par défaut, aucune valeur n’est spécifiée.	Double
Passer l’élément existant (Facultatif)	Spécifie si les statistiques seront calculées uniquement lorsqu’elles sont manquantes ou si elles seront régénérées même si elles existent. Activé—Les statistiques sont calculées même si elles existent déjà, et les statistiques existantes vont être remplacées. Il s’agit de l’option par défaut. Décoché—Les statistiques ne sont calculées que si elles n’existent pas déjà.	Boolean

Sortie dérivée

Etiqueter	Explication	Type de données
Réussite de l’opération Calculer les statistiques par lot	Indique si l’outil a réussi ou non.	Boolean

arcpy.management.BatchCalculateStatistics(Input_Raster_Datasets, {Number_of_columns_to_skip}, {Number_of_rows_to_skip}, {Ignore_values}, {Skip_Existing})

Nom	Explication	Type de données
Input_Raster_Datasets [input_raster_dataset,...]	Les jeux de données raster en entrée.	Raster Dataset
Number_of_columns_to_skip (Facultatif)	Nombre de pixels horizontaux entre échantillons. Un pas d’échantillonnage contrôle la partie du raster qui est utilisée dans le calcul des statistiques. La valeur en entrée indique le pas d’échantillonnage horizontal ou vertical : la valeur 1 utilise chaque pixel et la valeur 2 utilise un pixel sur deux. Le pas d’échantillonnage peut uniquement s’étendre de la valeur 1 au nombre de colonnes/lignes du raster. Cette valeur doit être supérieure à 0 et inférieure ou égale au nombre de colonnes du raster. La valeur par défaut est égale à 1 ou au dernier pas d’échantillonnage utilisé. Les pas d’échantillonnage sont différents pour les jeux de données raster stockés dans une géodatabase fichier ou une géodatabase d’entreprise. Tout d’abord, si les pas d’échantillonnage x et y sont différents, c’est le pas le plus petit qui est utilisé. Ensuite, le pas d’échantillonnage est lié au niveau de pyramide le mieux adapté au pas choisi. Si la valeur du pas d’échantillonnage est différente du nombre de pixels d’une structure pyramidale, le nombre est arrondi au niveau de pyramide suivant et ces statistiques sont utilisées.	Long
Number_of_rows_to_skip (Facultatif)	Nombre de pixels verticaux entre les échantillons. Un pas d’échantillonnage contrôle la partie du raster qui est utilisée dans le calcul des statistiques. La valeur en entrée indique le pas d’échantillonnage horizontal ou vertical : la valeur 1 utilise chaque pixel et la valeur 2 utilise un pixel sur deux. Le pas d’échantillonnage peut uniquement s’étendre de la valeur 1 au nombre de colonnes/lignes du raster. Cette valeur doit être supérieure à 0 et inférieure ou égale au nombre de lignes du raster. La valeur par défaut est égale à 1 ou à la valeur du dernier pas d’échantillonnage y utilisé. Les pas d’échantillonnage sont différents pour les jeux de données raster stockés dans une géodatabase fichier ou une géodatabase d’entreprise. Tout d’abord, si les pas d’échantillonnage x et y sont différents, c’est le pas le plus petit qui est utilisé. Ensuite, le pas d’échantillonnage est lié au niveau de pyramide le mieux adapté au pas choisi. Si la valeur du pas d’échantillonnage est différente du nombre de pixels d’une structure pyramidale, le nombre est arrondi au niveau de pyramide suivant et ces statistiques sont utilisées.	Long
Ignore_values [ignore_value,...] (Facultatif)	Valeurs de pixel à ne pas inclure dans le calcul de statistiques. Par défaut, aucune valeur n’est spécifiée.	Double
Skip_Existing (Facultatif)	Spécifie si les statistiques seront calculées uniquement lorsqu’elles sont manquantes ou si elles seront régénérées même si elles existent. `OVERWRITE`—Les statistiques sont calculées même si elles existent déjà, et les statistiques existantes vont être remplacées. Il s’agit de l’option par défaut. `SKIP_EXISTING`—Les statistiques ne sont calculées que si elles n’existent pas déjà.	Boolean

Sortie dérivée

Nom	Explication	Type de données
Batch_Calculate_Statistics_Succeeded	Indique si l’outil a réussi ou non.	Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction BatchCalculateStatistics (fenêtre Python)

Ceci est un exemple de script Python pour BatchCalculateStatistics.

import arcpy
arcpy.management.BatchCalculateStatistics(
     ["C:/data/img1.tif", "C:/data/img2.jp2"],
     5, 5, [0, 255], "SKIP_EXISTING")

Exemple 2 d’utilisation de la fonction BatchCalculateStatistics (script autonome)

Ceci est un exemple de script Python pour BatchCalculateStatistics.

# Calculate Statistics for multiple raster datasets with
# multiple ignore values.
# Skip datasets that already have the statistics.

import arcpy
arcpy.env.workspace = "C:/Workspace"

inras = ["image1.tif", "image2.img", "fgdb.gdb/image3"]
skipcol = 5
skiprow = 5
ignoreval = [0, 255, 21]
skipexist = "SKIP_EXISTING"

arcpy.management.BatchCalculateStatistics(
     inras, skipcol, skiprow, ignoreval,skipexist)

Environnements

Espace de travail courant, Statistiques raster, Espace de travail temporaire

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Calculer les statistiques par lots (Outils de gestion des données)

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes