Résumé
Calcule des statistiques pour un jeu de données raster ou une 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
Le calcul des statistiques permet aux applications ArcGIS d'étirer et de symboliser correctement les données raster à afficher.
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.
Lors de l'utilisation de cet outil pour calculer des statistiques sur une 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 fortement recommandé de préciser un pas d'échantillonnage pour une mosaïque car ces jeux de données ont 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.
Syntaxe
CalculateStatistics_management (in_raster_dataset, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {skip_existing}, {area_of_interest})
Paramètre | 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. 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. 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 ce sont les dernières valeurs non significatives qui sont utilisées. | Long |
skip_existing (Facultatif) | Spécifiez s'il convient de calculer des statistiques uniquement lorsqu'elles sont manquantes ou de les régénérer même si elles existent.
| Boolean |
area_of_interest (Facultatif) | Indiquez une classe d'entités qui représente une surface dans le jeu de données à partir de laquelle vous souhaitez calculer les statistiques pour qu'elles ne soient pas générées à partir du jeu de données entier. | Feature Set |
Sortie dérivée
Nom | Explication | Type de données |
out_raster |
Exemple de code
Exemple d'utilisation de l'outil CalculateStatistics 1 (fenêtre Python)
Ceci est un exemple Python pour CalculateStatistics.
import arcpy
arcpy.CalculateStatistics_management(
"C:/data/image.tif", "5", "5", "0;255",
"SKIP_EXISTING", "c:/data/aoi.shp")
Exemple d'utilisation de l'outil CalculateStatistics 2 (fenêtre autonome)
Ceci est un exemple de script Python pour 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
Informations de licence
- ArcGIS Desktop Basic: Oui
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui
Rubriques connexes
- Présentation générale du jeu d'outils Raster
- Paramètres d'environnement des données raster
- Statistiques concernant les données raster
- Calcul de statistiques à l'aide d'outils de géotraitement
- Calcul de statistiques dans ArcCatalog
- Définition des paramètres de statistiques relatifs à l'environnement de géotraitement
- Définir les propriétés de raster