Calculer les statistiques (Gestion des données)

Synthèse

Calcule des statistiques pour un jeu de données raster ou un jeu de données mosaïque.

Des statistiques relatives aux jeux de données raster et aux mosaïques sont nécessaires à certaines tâches, notamment pour appliquer un étirement de contraste ou classifier les données.

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.

• Les pas d'échantillonnage sont assez différents pour les jeux de données raster stockés dans une géodatabase fichier ou 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 de 5 et que le niveau de pyramide le plus proche est de 4 x 4 pixels, c'est-à-dire de niveau 2), le logiciel arrondit au niveau de pyramide inférieur suivant (dans ce cas, 2) et utilise cette valeur comme pas d'échantillonnage.

• Un pas d'échantillonnage n'est pas utilisé pour tous les formats raster. Les formats raster qui calculent des statistiques et tirent avantage du pas d'échantillonnage sont notamment les formats TIFF, IMG, NITF, DTED, RAW, ADRG, CIB, CADRG, DIGEST, GIS, LAN, CIT, COT, ERMapper, ENVI DAT, BIL, BIP, BSQ et géodatabase.

• Lorsque vous utilisez cet outil pour calculer des statistiques sur un jeu de données mosaïque, ces dernières sont calculées pour l’image mosaïquée de niveau supérieur, et non pour chaque raster de la mosaïque.

• Il est recommandé de spécifier un pas d’échantillonnage pour une mosaïque, ces jeux de données ayant tendance à être très volumineux.

• L'option Ignorer les valeurs vous permet d'exclure une valeur spécifique du calcul des statistiques. Vous pouvez ignorer une valeur s'il s'agit d'une valeur NoData ou si elle est destinée à fausser votre calcul.

• Le calcul des statistiques aux formats Grid Esri et RADARSAT2 utilisent toujours un pas d'échantillonnage de 1.

• Lorsque vous utilisez cet outil pour calculer des statistiques sur un jeu de données mosaïque multidimensionnelles ou un raster multidimensionnel, les statistiques sont calculées pour chaque variable dans le jeu de données.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Jeu de données raster en entrée	Jeu de données raster ou mosaïque en entrée.	Mosaic Dataset; Mosaic Layer; 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 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 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
Ignorer les valeurs (Facultatif)	Valeurs de pixel à ne pas inclure dans le calcul de statistiques. Par défaut, aucune valeur n'est définie ou la dernière valeur ignorée est utilisée.	Long
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. Désactivé : 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. Activé - Les statistiques ne sont calculées que si elles n’existent pas.	Boolean
Zone d’intérêt (Facultatif)	Surface dans le jeu de données permettant de calculer les statistiques de sorte qu’elles ne soient pas générées à partir du jeu de données entier. Vous pouvez accéder à une classe d’entités ou créer un graphique surfacique dans la zone d’affichage.	Feature Set

Sortie obtenue

Étiquette	Explication	Type de données
Jeu de données raster en entrée mis à jour	Jeu de données raster en sortie.	Raster Dataset

Python

arcpy.management.CalculateStatistics(in_raster_dataset, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {skip_existing}, {area_of_interest})

Nom	Explication	Type de données
in_raster_dataset	Jeu de données raster ou mosaïque en entrée.	Mosaic Dataset; Mosaic Layer; Raster Dataset
x_skip_factor (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 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
y_skip_factor (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 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 définie ou la dernière valeur ignorée est utilisée.	Long
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
area_of_interest (Facultatif)	Classe d’entités qui représente une surface dans le jeu de données permettant de calculer les statistiques de sorte qu’elles ne soient pas générées à partir du jeu de données entier.	Feature Set

Sortie obtenue

Nom	Explication	Type de données
out_raster	Jeu de données raster en sortie.	Raster Dataset

Exemple de code

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

Il s’agit d’un exemple Python d’utilisation de la fonction CalculateStatistics.

import arcpy
arcpy.CalculateStatistics_management(
     "C:/data/image.tif", "5", "5", "0;255", 
     "SKIP_EXISTING", "c:/data/aoi.shp")

Exemple 2 d'utilisation de l'outil CalculateStatistics (script autonome)

Il s’agit d’un exemple de script Python d’utilisation de la fonction CalculateStatistics.

# Calculate Statistics for single raster dataset

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
arcpy.CalculateStatistics_management("image.tif", "4", "6", "0;255;21")

Environnements

Espace de travail courant, Facteur de traitement parallèle, Statistiques raster, Espace de travail temporaire