Statistiques focales (ArcGIS Spatial Analyst)

Récapitulatif

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

OutRas = FocalStatistics(InRas1, NbrRectangle(3,3,MAP), "SUM", "")

Utilisation

• Si le raster en entrée est de type virgule flottante, seules les statistiques Moyenne, Maximum, Minimum, Plage, ECARTYPE 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.

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 Voisinage 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 : NbrAnnulus({innerRadius}, {outerRadius}, {units}) NbrCircle({radius}, {units} NbrRectangle({width}, {height}, {units}) NbrWedge({radius}, {startAngle}, {endAngle}, {units}) NbrIrregular(inKernelFile) NbrWeight(inKernelFile) 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. MOYENNE — Calcule la moyenne des cellules du voisinage. MAJORITY — Calcule la majorité (valeur la plus fréquente) des cellules du voisinage. MAXIMUM — Calcule le maximum (valeur la plus élevée) des cellules du voisinage. MEDIANE — Calcule la médiane des cellules du voisinage. MINIMUM — Calcule le minimum (valeur la plus faible) des cellules du voisinage. MINORITY — Calcule la minorité (valeur la moins fréquente) des cellules du voisinage. PLAGE — Calcule la plage (différence entre la valeur la plus élevée et la valeur la plus faible) des cellules du voisinage. ECART TYPE — Calcule l'écart type des cellules du voisinage. SUM — Calcule la somme (total de toutes les valeurs) des cellules du voisinage. VARIETE — Calcule la variété (le nombre de valeurs uniques) des cellules du voisinage. Le type de statistiques par défaut est MEAN. Si le raster en entrée est à 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. DATA — Précise que 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. NODATA —Précise que 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

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

Taille de cellule, Espace de travail courant, Masque, Système de coordonnées en sortie, Etendue, Espace de travail temporaire, Raster de capture

Informations de licence

ArcGIS for Desktop Basic: Requis ArcGIS Spatial Analyst

ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst

ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst