Statistiques focales (Spatial Analyst)—ArcGIS Pro

Disponible avec une licence Spatial Analyst.

Disponible avec une licence Image Analyst.

Synthèse

Pour chaque cellule, cet outil permet de calculer l'emplacement d'une statistique dans le voisinage.

En savoir plus sur le fonctionnement de l’outil Statistiques focales

Illustration

Valeurs en entrée et en sortie de l’outil Statistiques focales avec la statistique Somme définie — OutRas = FocalStatistics(InRas1, NbrRectangle(3,3,MAP), "SUM", "")

Utilisation

Si le raster en entrée est entier, tous les types de statistiques sont disponibles. Si le raster en entrée est à virgule flottante, seules les statistiques Moyenne, Maximum, Médiane, Minimum, Pourcentage, Plage, Ecart type et Somme sont disponibles. Les statistiques Majorité, Minorité et Variété ne sont pas autorisées.
Lorsque vous indiquez un voisinage circulaire, en anneau ou en secteur, certaines cellules diagonales extérieures ne sont pas toujours prises en compte dans les calculs. En effet, le centre d’une cellule doit figurer dans le voisinage.
Les types de voisinage (Neighborhood) Irrégulier et Pondération nécessitent qu’un fichier de noyau (Kernel file) soit spécifié. Les fichiers de noyau doivent avoir une extension de fichier .txt.
Consultez les sections Irrégulière et Pondération de la rubrique En savoir plus sur le fonctionnement de l’outil Statistiques focales pour plus d’informations sur la création et l’utilisation d’un fichier de noyau.
Vous pouvez définir le type Neighborhood (Voisinage) sur Weight (Poids) seulement pour les types de statistiques Moyenne, Ecart type ou Somme.
Les cellules NoData en entrée peuvent recevoir une valeur dans la sortie si le paramètre Ignore NoData in calculations (Ignorer NoData dans les calculs) est activé, à condition qu’au moins une cellule du voisinage présente une valeur valide.
Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Paramètres

Étiquette	Explication	Type de données
Raster en entrée	Raster sur lequel les statistiques focales pour chaque cellule en entrée sont calculées.	Raster Layer
Quartier (Facultatif)	Cellules qui entourent une cellule de traitement qui sera utilisée dans le calcul des statistiques. Vous avez le choix entre plusieurs types de voisinage prédéfinis, ou vous pouvez définir un noyau personnalisé. Une fois le type de voisinage sélectionné, d’autres paramètres peuvent être configurés pour définir entièrement la forme, la taille et les unités de mesure. Le voisinage par défaut est un rectangle carré avec une largeur et une hauteur de trois cellules. Voici les formes des types de voisinage pris en charge : Anneau, Rayon intérieur, Rayon extérieur, Unités Voisinage en forme de tore (anneau) défini par un rayon intérieur et un rayon extérieur. L'anneau par défaut a un rayon intérieur d'une cellule et un rayon extérieur de trois cellules. Cercle, Rayon, Unités Voisinage circulaire doté d'un rayon donné. Le rayon par défaut est de trois cellules. Rectangle, Hauteur, Largeur, Unités Voisinage rectangulaire défini par la hauteur et la largeur. La valeur par défaut est un carré avec une hauteur et une largeur de trois cellules. Secteur, Rayon, Angle de départ, Angle de fin, Unités Voisinage en forme de secteur défini par un rayon, l'angle de début et l'angle de fin. 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. Irrégulier, Fichier de noyau Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié. Pondération, Fichier de noyau Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié, lequel peut appliquer des pondérations aux membres du voisinage. Pour les voisinages de type Anneau, Cercle, Rectangle et Secteur, les unités de distance des paramètres peuvent être spécifiées en unités de cellule ou de Carte. Les unités de cellule sont privilégiées par défaut. Pour les voisinages de noyaux, la première ligne du fichier de noyau définit la largeur et la hauteur du voisinage en nombre de cellules. Les lignes suivantes indiquent comment la valeur en entrée correspondant à cette localisation dans le noyau sera traitée. La valeur 0 dans le fichier de noyau pour le type de voisinage Irrégulier ou Pondération indique que la localisation correspondante ne sera pas incluse dans le calcul. Pour le voisinage de type Irrégulier, la valeur 1 dans le fichier de noyau indique que la cellule en entrée correspondante sera incluse dans l’opération. Pour le voisinage de type Pondération, la valeur à chaque position indique par quel facteur la valeur de la cellule en entrée correspondante doit être multipliée. Vous pouvez utiliser des valeurs positives, négatives et décimales.	Neighborhood
Type de statistique (Facultatif)	Spécifie le type de statistique à calculer. Le type de statistique par défaut est Moyenne. Si le raster en entrée est entier, tous les types de statistiques sont disponibles. Si le raster en entrée est à 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. Moyenne—La moyenne (valeur moyenne) des cellules du voisinage est calculée. Majorité—La majorité (valeur la plus fréquente) des cellules du voisinage est identifiée. Maximum—Le maximum (valeur la plus élevée) des cellules du voisinage est identifié. Médiane—La médiane des cellules du voisinage est calculée. Minimal—Le minimum (valeur la plus faible) des cellules du voisinage est identifié. Minorité—La minorité (valeur la moins fréquente) des cellules du voisinage est identifiée. Pourcentage—Un centile des cellules du voisinage est calculé. Le 90è centile est calculé par défaut. Vous pouvez spécifier d’autres valeurs (entre 0 et 100) à l’aide du paramètre Percentile value (Valeur de pourcentage). Plage—La plage (différence entre la valeur la plus élevée et la valeur la plus faible) des cellules du voisinage est calculée. Écart type—L’écart type des cellules du voisinage est calculé. Somme—La somme des cellules du voisinage est calculée. Variété—La variété (le nombre de valeurs uniques) des cellules du voisinage est calculée.	String
Ignorer NoData dans les calculs (Facultatif)	Précise 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. Cela signifie que si la cellule de traitement a une valeur NoData, la cellule de traitement peut se voir attribuer une valeur dans le raster en sortie si ce paramètre est activé, à condition qu’au moins une cellule du voisinage présente une valeur valide. Il s’agit de l’option par défaut. Désactivé : si une cellule d’un voisinage a une valeur NoData, cellule de traitement comprise, la sortie de la cellule de traitement est NoData. Si ce paramètre n’est pas activé, la présence d’une valeur NoData implique que les informations sont insuffisantes pour déterminer la valeur statistique du voisinage.	Boolean
Valeur du pourcentage (Facultatif)	Pourcentage à calculer. La valeur par défaut est de 90, soit le 90è centile. Les valeurs peuvent varier entre 0 et 100. Le centile n° 0 est équivalent à la statistique Minimum tandis que le 100è centile équivaut à Maximum. Une valeur de 50 donne le même résultat que la statistique Médiane. Cette option est prise en charge seulement si le paramètre Statistics type (Type de statistique) est défini sur Percentile (Pourcentage). Si d’autres types de statistiques ont été spécifiés, ce paramètre est ignoré.	Double

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Raster de statistiques focales en sortie.	Raster

FocalStatistics(in_raster, {neighborhood}, {statistics_type}, {ignore_nodata}, {percentile_value})

Nom	Explication	Type de données
in_raster	Raster sur lequel les statistiques focales pour chaque cellule en entrée sont calculées.	Raster Layer
neighborhood (Facultatif)	Cellules qui entourent une cellule de traitement qui sera utilisée dans le calcul des statistiques. Vous avez le choix entre plusieurs types de voisinage prédéfinis, ou vous pouvez définir un noyau personnalisé. Une fois le type de voisinage sélectionné, d’autres paramètres peuvent être configurés pour définir entièrement la forme, la taille et les unités de mesure. Le voisinage par défaut est un rectangle carré avec une largeur et une hauteur de trois cellules. La forme des voisinages est définie par la classe Neighborhood. Les types de voisinage pris en charge sont NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge, NbrIrregular, et NbrWeight. Voici les formes des types de voisinage pris en charge : NbrAnnulus({innerRadius}, {outerRadius}, {units}) Voisinage en forme de tore (anneau) défini par un rayon intérieur et un rayon extérieur. L'anneau par défaut a un rayon intérieur d'une cellule et un rayon extérieur de trois cellules. NbrCircle({radius}, {units} Voisinage circulaire doté d'un rayon donné. Le rayon par défaut est de trois cellules. NbrRectangle({width}, {height}, {units}) Voisinage rectangulaire défini par la hauteur et la largeur. La valeur par défaut est un carré avec une hauteur et une largeur de trois cellules. NbrWedge({radius}, {startAngle}, {endAngle}, {units}) Voisinage en forme de secteur défini par un rayon, l'angle de début et l'angle de fin. 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. NbrIrregular(inKernelFile) Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié. NbrWeight(inKernelFile) Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié, lequel peut appliquer des pondérations aux membres du voisinage. Pour les voisinages NbrAnnulus, Nbrcircle, NbrRectangle et NbrWedge, les unités de distance des paramètres peuvent être spécifiées en unités CELL ou en unités MAP. Les unités de cellule sont privilégiées par défaut. Pour les voisinages de noyaux, la première ligne du fichier de noyau définit la largeur et la hauteur du voisinage en nombre de cellules. Les lignes suivantes indiquent comment la valeur en entrée correspondant à cette localisation dans le noyau sera traitée. La valeur 0 dans le fichier de noyau pour le type de voisinage Irrégulier ou Pondération indique que la localisation correspondante ne sera pas incluse dans le calcul. Pour le voisinage de type Irrégulier, la valeur 1 dans le fichier de noyau indique que la cellule en entrée correspondante sera incluse dans l’opération. Pour le voisinage de type Pondération, la valeur à chaque position indique par quel facteur la valeur de la cellule en entrée correspondante doit être multipliée. Vous pouvez utiliser des valeurs positives, négatives et décimales.	Neighborhood
statistics_type (Facultatif)	Spécifie le type de statistique à calculer. MEAN—La moyenne (valeur moyenne) des cellules du voisinage est calculée. MAJORITY—La majorité (valeur la plus fréquente) des cellules du voisinage est identifiée. MAXIMUM—Le maximum (valeur la plus élevée) des cellules du voisinage est identifié. MEDIAN—La médiane des cellules du voisinage est calculée. MINIMUM—Le minimum (valeur la plus faible) des cellules du voisinage est identifié. MINORITY—La minorité (valeur la moins fréquente) des cellules du voisinage est identifiée. PERCENTILE—Un centile des cellules du voisinage est calculé. Le 90è centile est calculé par défaut. Vous pouvez spécifier d’autres valeurs (entre 0 et 100) à l’aide du paramètre percentile_value. RANGE—La plage (différence entre la valeur la plus élevée et la valeur la plus faible) des cellules du voisinage est calculée. STD—L’écart type des cellules du voisinage est calculé. SUM—La somme des cellules du voisinage est calculée. VARIETY—La variété (le nombre de valeurs uniques) des cellules du voisinage est calculée. Le type de statistique par défaut est MEAN. Si le raster en entrée est entier, tous les types de statistiques sont disponibles. Si le raster en entrée est à virgule flottante, seuls les types de statistiques MEAN, MAXIMUM, MEDIAN, MINIMUM, PERCENTILE, RANGE, STD et SUM sont disponibles.	String
ignore_nodata (Facultatif)	Précise si les valeurs NoData sont ignorées par le calcul de statistiques. DATA—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. Cela signifie que si la cellule de traitement a une valeur NoData, la cellule de traitement peut se voir attribuer une valeur dans le raster en sortie si cette option est sélectionnée, à condition qu’au moins une cellule du voisinage présente une valeur valide. Il s’agit de l’option par défaut. NODATA—Si une cellule d’un voisinage a une valeur NoData, la sortie de la cellule de traitement est NoData. Avec cette option, la présence d'une valeur NoData implique que les informations sont insuffisantes pour calculer les statistiques pour le voisinage.	Boolean
percentile_value (Facultatif)	Pourcentage à calculer. La valeur par défaut est de 90, soit le 90è centile. Les valeurs peuvent varier entre 0 et 100. Le centile n° 0 est équivalent à la statistique Minimum tandis que le 100è centile équivaut à Maximum. Une valeur de 50 donne le même résultat que la statistique Médiane. Cette option est uniquement prise en charge si le paramètre statistics_type est défini sur PERCENTILE. Si d’autres types de statistiques ont été spécifiés, ce paramètre est ignoré.	Double

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Raster de statistiques focales en sortie.	Raster

Exemple de code

Premier exemple d'utilisation de l'outil FocalStatistics (fenêtre Python)

Cet exemple décrit le calcul de la valeur la moins récurrente dans un voisinage en anneau autour de chaque cellule dans un raster en entrée.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFocalStat = FocalStatistics("elevation", NbrAnnulus(5, 10, "CELL"), 
                               "MINORITY", "NODATA")
outFocalStat.save("C:/sapyexamples/output/focalstat01")

Deuxième exemple d'utilisation de l'outil FocalStatistics (script autonome)

Dans cet exemple, on définit la valeur la moins récurrente dans un voisinage de 10 x 10 autour de chaque cellule dans le raster en entrée.

# Name: FocalStatistics_Ex_02.py
# Description: Calculates a statistic on a raster over a specified
#    neighborhood.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
neighborhood = NbrRectangle(10, 10, "CELL")

# Execute FocalStatistics
outFocalStatistics = FocalStatistics(inRaster, neighborhood, "MINORITY",
                                     "")

# Save the output 
outFocalStatistics.save("C:/sapyexamples/output/focalstatout")

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Compression, Espace de travail courant, Étendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Facteur de traitement parallèle, Espace de travail temporaire, Raster de capture, Taille de tuile

Synthèse

Illustration

Utilisation

Paramètres

Valeur renvoyée

Valeur renvoyée

Exemple de code

Environnements

Cas particuliers

Informations de licence

Rubriques connexes

Dans cette rubrique