Fonction statistique focale

Vue d'ensemble

Calcule les statistiques sur les cellules dans un voisinage autour de chaque cellule d’un raster en entrée. Plusieurs formes de voisinage sont disponibles.

Remarques

Si le raster en entrée est de type virgule flottante, seules les statistiques Mean (Moyenne), Maximum, Median (Médiane), Minimum, Percentile (Pourcentage), Range (Plage), Standard deviation (Écart type) et Sum (Somme) sont disponibles.

Lorsque vous indiquez un voisinage circulaire, en anneau ou en secteur, certaines cellules diagonales ne sont pas toujours prises en compte dans les calculs. En effet, le centre d'une cellule doit figurer dans le voisinage.

Les cellules NoData en entrée peuvent recevoir une valeur dans la sortie si l’option Ignore NoData in Calculations (Ignorer les valeurs NoData dans les calculs) est sélectionnée, à condition qu’au moins une cellule du voisinage présente une valeur valide.

Pour plus d’informations sur cette fonction, reportez-vous à la rubrique Fonctionnement de l’outil Statistiques focales.

Paramètres

Nom de paramètreDescription

Raster

(Requis)

Raster en entrée.

Quartier

La forme de la zone autour de chaque cellule utilisée pour le calcul des statistiques.

Chaque voisinage possède des paramètres supplémentaires avec lesquels définir la forme.

  • Rectangle, Width (Largeur), Height (Hauteur)

    Voisinage rectangulaire défini par la hauteur et la largeur. La valeur minimale pour la largeur ou la hauteur est d’1 cellule et la valeur maximale est de 4 096 cellules. La valeur par défaut est un carré avec une hauteur et une largeur de trois cellules.

  • Circle (Cercle), Radius (Rayon)

    Voisinage circulaire doté d'un rayon donné. La valeur de rayon minimale est d’1 cellule et la valeur maximale est de 2 047 cellules. Le rayon par défaut est de trois cellules.

  • Annulus (Anneau), Inner radius (Rayon intérieur), Outer radius (Rayon extérieur)

    Voisinage en forme de boucle ou d’anneau défini par un rayon intérieur et un rayon extérieur. La valeur de rayon minimale est d’1 cellule et le rayon extérieur doit être plus grand que le rayon intérieur. Le rayon intérieur maximal est de 2 046 cellules et le rayon extérieur maximale est de 2 047 cellules. L’anneau par défaut a un rayon intérieur d’une cellule et un rayon extérieur de trois cellules.

  • Wedge (Secteur), Radius (Rayon), Start angle (Angle de départ), End angle (Angle d’arrivée)

    Voisinage en forme de secteur défini par un rayon, l’angle de départ et l’angle d’arrivée. La valeur de rayon minimale est d’1 cellule et la valeur maximale est de 2 047 cellules. Il s'étend dans le sens anti-horaire, de l'angle de départ vers l'angle d'arrivée. Les angles sont précisés en degrés, 0 ou 360 représentant l'Est. Vous pouvez utiliser des angles négatifs. Le secteur par défaut s'étend de 0 à 90 degrés, avec un rayon de trois cellules.

  • Irregular (Irrégulier), Width (Largeur), Height (Hauteur), Neighborhood values (Valeurs voisines)

    Le voisinage irrégulier permet de spécifier un voisinage de forme irrégulière, ou noyau, autour de la cellule de traitement. Utilisez la table des valeurs voisines pour définir la forme du noyau de voisinage. La valeur 1 indique que la cellule correspondante est un membre du voisinage (de même que sa valeur). Utilisez la valeur 0 pour exclure une cellule du traitement. La valeur minimale pour la largeur ou la hauteur du noyau est d’1 cellule et la valeur maximale est de 4 096 cellules.

  • Weight (Pondération), Width (Largeur), Height (Hauteur), Neighborhood values (Valeurs voisines)

    Similaire au type de voisinage irrégulier, le voisinage de type pondération vous permet de définir un voisinage irrégulier autour de la cellule de traitement, mais vous permet également d’appliquer des pondérations aux valeurs en entrée. Les valeurs du noyau de pondération spécifient les positions de cellule qui doivent être comprises dans le voisinage et les pondérations par lesquelles elles seront multipliées. Utilisez la valeur 0 pour exclure une cellule du traitement. Les valeurs décimales peuvent être utilisées en tant que valeurs de pondération. La valeur minimale pour la largeur ou la hauteur du noyau est d’1 cellule et la valeur maximale est de 4 096 cellules.

Remarque :

Pour le type de voisinage de pondération, seules les statistiques Moyenne, Écart type ou Somme sont prises en charge.

Type de statistique

Spécifie le type de statistique à calculer.

  • Mean (Moyenne) : calcule la moyenne des cellules du voisinage.
  • Majority (Majorité) : détermine la majorité (valeur la plus fréquente) des cellules du voisinage.
  • Maximum : détermine le maximum (valeur la plus élevée) des cellules du voisinage.
  • Median (Médiane) : calcule la médiane des cellules du voisinage. La médiane équivaut au 50e centile.
  • Minimum : détermine le minimum (valeur la plus faible) des cellules du voisinage.
  • Minority (Minorité) : détermine la minorité (valeur la moins fréquente) des cellules du voisinage.
  • Percentile (Pourcentage) : calcule un pourcentage des cellules du voisinage . Lorsque ce type de statistique est sélectionné, un nouveau paramètre Percentile Value (Valeur de pourcentage) est disponible afin de déterminer le pourcentage à calculer.
  • Range (Plage) : détermine la plage (différence entre la valeur la plus élevée et la valeur la plus faible) des cellules du voisinage.
  • Standard Deviation (Écart type) : calcule l’écart type des cellules du voisinage.
  • Sum (Somme) : calcule la somme (total de toutes les valeurs) des cellules du voisinage.
  • Variety (Variété) : calcule la variété (le nombre de valeurs uniques) des cellules du voisinage.

Le type de statistiques par défaut est Moyenne.

Si le raster en entrée est de type virgule flottante, seuls les types de statistiques Mean (Moyenne), Maximum, Median (Médiane), Minimum, Percentile (Pourcentage), Range (Plage), Standard deviation (Écart type) et Sum (Somme) sont disponibles.

Pour Mean (Moyenne), Median (Médiane), Percentile (Pourcentage) et Standard Deviation (Écart type), la sortie est toujours de type virgule flottante.

Pour Majority (Majorité) et Minority (Minorité), s’il existe une association entre les valeurs ayant la fréquence la plus élevée (majorité) et la plus faible (minorité) dans le voisinage, l’emplacement de la cellule de traitement reçoit la valeur la plus petite des valeurs associées. Si la valeur de la cellule de traitement elle-même est l’une des valeurs associées, cette valeur est renvoyée à la place.

Ignorer NoData dans les calculs

Indique si les valeurs NoData sont ignorées par le calcul de statistiques.

  • Activé : si une valeur NoData existe dans un voisinage, elle est ignorée. Seules les cellules du voisinage dotées de valeurs de données sont utilisées dans la détermination de la valeur en sortie. Il s’agit de l’option par défaut.
  • Désactivé : si une cellule d’un voisinage a une valeur NoData, la sortie de la cellule de traitement est NoData.

Valeur du centile

Indique le centile à calculer lorsque le type de statistique Percentile (Centile) est sélectionné. La valeur par défaut est de 90, soit le 90è centile.

Les valeurs peuvent s’échelonner de 0 à 100. Le pourcentage nul est généralement équivalent à la statistique Minimum et le pourcentage 100 est équivalent à la statistique Maximum, à l’exception près que le résultat est de type virgule flottante. Une valeur de 50 donne généralement le même résultat que la statistique Median (Médiane).

Fichiers de noyau

Dans le cas de voisinages de type Irregular (Irrégulier) et Weight (Pondération), vous pouvez enregistrer un noyau personnalisé sous forme de fichier texte en vue d’une utilisation ultérieure.

Après avoir saisi la largeur et la hauteur, et avoir entré les valeurs de voisinage, cliquez sur le bouton Save As (Enregistrer sous) pour l’exporter vers un fichier texte ASCII via la boîte de dialogue Save Neighborhood Kernel File (Enregistrer le fichier de noyau de voisinage). Utilisez le bouton Browse (Parcourir) pour ouvrir la boîte de dialogue Input Neighborhood Kernel File (Fichier de noyau de voisinage en entrée) et accéder à un fichier de noyau existant à charger.

La première ligne dans le fichier de noyau enregistre la largeur et la hauteur du voisinage du noyau en nombres de cellules. La ligne suivante indique le mode de traitement de la valeur en entrée qui correspond à cet emplacement dans le noyau.

Une valeur 0 dans le fichier de noyau pour le voisinage de type irrégulier ou pondération indique que l’emplacement correspondant n’est pas inclus dans le calcul. Dans le cas du voisinage irrégulier, une valeur 1 dans le fichier de noyau indique que la cellule en entrée correspondante est incluse dans l’opération. Dans le cas du voisinage de type pondération, la valeur de chaque position indique la valeur par laquelle la cellule en entrée correspondante doit être multipliée. Les valeurs positives, négatives et décimales peuvent être utilisées en tant que valeurs de pondération.