Statistiques raster (paramètre d’environnement)

Les outils dédiés à l'environnement Statistiques raster contrôlent le mode de génération des statistiques pour les jeux de données raster en sortie.

L'option Statistiques permet de calculer des statistiques pour le jeu de données raster en sortie. Des statistiques relatives au jeu de données raster sont nécessaires à certaines tâches dans l’application, notamment pour appliquer un étirement de contraste ou classifier les données. Il n'est pas essentiel de générer des statistiques si elles n'ont pas déjà été calculées, car les statistiques sont calculées dès qu'elles sont requises pour la première fois. Nous vous conseillons toutefois de calculer les statistiques avant d'utiliser le jeu de données raster si vous devez employer certaines entités nécessitant des statistiques.

Remarques sur l'utilisation

• Des statistiques relatives à un jeu de données raster sont nécessaires à certaines tâches dans l’application, notamment pour appliquer un étirement de contraste ou classifier les données.
• Il est toutefois recommandé de calculer les statistiques des jeux de données raster avant d’exploiter ces derniers au moyen de fonctions qui requièrent des statistiques.
• Le pas d'échantillonnage permet d'accélérer le calcul de statistiques en ignorant certains pixels.
• Les valeurs non significatives s’appliquent aux valeurs qui ne font pas partie du calcul des statistiques. En règle générale, vous pouvez ignorer les valeurs d’arrière-plan.
• Les pas d’échantillonnage sont différents pour les jeux de données raster stockés dans une géodatabase. 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 spécifié. 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.
• Reportez-vous à la rubrique Matrice de stockage des données raster pour connaître les formats de stockage de données raster pouvant être contrôlés à l’aide de ce paramètre.

Syntaxe de la boîte de dialogue

• Calculer les statistiques – Cochez cette case pour calculer des statistiques.
• Pas d’échantillonnage statistique – Choisissez d'ignorer des pixels entre les échantillons.
  • Pas d'échantillonnage X – Nombre de pixels horizontaux entre les échantillons. Cette valeur doit être supérieure à zéro et inférieure ou égale au nombre de colonnes du jeu de données raster. La valeur par défaut est égale à 1 ou au dernier pas d'échantillonnage utilisé.
  • Pas d'échantillonnage Y – Nombre de pixels verticaux entre les échantillons. Cette valeur doit être supérieure à zéro et inférieure ou égale au nombre de lignes du jeu de données raster. La valeur par défaut est égale à 1 ou au dernier pas d'échantillonnage utilisé.
• Valeur statistique non significative – Une ou plusieurs valeurs non significatives, telles qu'une valeur d'arrière-plan, ne faisant pas partie du calcul des statistiques. Les valeurs multiples sont séparées par des points-virgule.

Syntaxe de script

arcpy.env.rasterStatistics = "calculate_statistics {x_skip_factor} {y_skip_factor} {statistics_ignore_value}"

Syntaxe rasterStatistics

Paramètre	Explication
calculate_statistics (Obligatoire)	Pour calculer les statistiques, utilisez STATISTICS ; sinon, spécifiez NONE.
x_skip_factor (Facultatif)	Pas d’échantillonnage de l’axe x.
y_skip_factor (Facultatif)	Pas d’échantillonnage de l’axe y.
statistics_ignore_value (Facultatif)	Une ou plusieurs valeurs non significatives, telles qu’une valeur d’arrière-plan, ne faisant pas partie du calcul des statistiques. Les valeurs multiples sont séparées par des espaces.

Exemple de script

import arcpy

# Statistics using a skip factor of 100 for x and y, and 
# ignore values of 0 and 255
arcpy.env.rasterStatistics = 'STATISTICS 100 100 (0 255)'