Disponible avec une licence Spatial Analyst.
Résumé
Pour chaque cellule, cet outil permet de calculer l'emplacement d'une statistique dans le voisinage.
Pour en savoir plus sur le fonctionnement de l'outil Statistiques focales
Illustration
Utilisation
Si le raster en entrée est de type virgule flottante, seules les statistiques Moyenne, Maximum, Minimum, Plage, Ecart type et Somme sont disponibles. Les statistiques Majorité, Minorité, Médiane et Variété ne sont pas autorisées. Si le raster en entrée est de type entier, tous les types de statistiques 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 types de voisinage Irrégulier et Pondération nécessitent qu'un fichier de noyau soit spécifié. Les fichiers de noyau doivent avoir une extension de fichier .txt.
Pour plus d'informations sur l'utilisation d'un fichier noyau, consultez les sections Irrégulier et Pondération dans la rubrique Fonctionnement de l'outil Statistiques focales.
Vous pouvez uniquement associer un voisinage de type Moyenne, Ecart type ou Somme à la fonction Poids.
Les cellules NoData en entrée peuvent recevoir une valeur dans la sortie si l'option Ignorer 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 les environnements de géotraitement qui s'appliquent à cet outil, reportez-vous à la rubrique Environnements d'analyse et Spatial Analyst.
Syntaxe
FocalStatistics (in_raster, {neighborhood}, {statistics_type}, {ignore_nodata})
Paramètre | Explication | Type de données |
in_raster | Raster sur lequel vous effectuez des calculs de statistiques focales. | Raster Layer |
neighborhood (Facultatif) | La classe Neighborhood dicte la forme de la zone autour de chaque cellule utilisée pour le calcul des statistiques. Les différents types de voisinage disponibles sont NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge, NbrIrregular, et NbrWeight. Formes des voisinages :
Le voisinage par défaut est un voisinage NbrRectangle carré avec une largeur et une hauteur de 3 cellules. | Neighborhood |
statistics_type (Facultatif) | Type de statistique à calculer.
Le type de statistiques par défaut est MEAN. Si le raster en entrée est de type virgule flottante, seuls les types de statistiques MEAN, MAXIMUM, MINIMUM, RANGE, STD, et SUM sont disponibles. | String |
ignore_nodata (Facultatif) | Indique si les valeurs NoData sont ignorées par le calcul de statistiques.
| Boolean |
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")
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute FocalStatistics
outFocalStatistics = FocalStatistics(inRaster, neighborhood, "MINORITY",
"")
# Save the output
outFocalStatistics.save("C:/sapyexamples/output/focalstatout")
Environnements
Informations de licence
- ArcGIS Desktop Basic: Requiert Spatial Analyst
- ArcGIS Desktop Standard: Requiert Spatial Analyst
- ArcGIS Desktop Advanced: Requiert Spatial Analyst