Filtrer (Spatial Analyst)

Synthèse

Permet de lisser (passe-bas) ou d'améliorer le filtrage (passe-haut) dans un raster.

Pour en savoir plus sur l'outil Filtre

Utilisation

• L’option de filtre Low pass (Passe-bas) (LOW en Python) permet de filtrer les moyennes (lissage). L’option High pass (Passe-haut) (HIGH en Python) est un filtre d’optimisation des tronçons.

• Les cellules NoData en entrée peuvent recevoir une valeur dans la sortie si l’option Ignore NoData in calculations (Ignorer NoData dans les calculs) est sélectionnée (ignore_nodata défini sur NODATA en Python), à condition qu’au moins une cellule du voisinage de filtrage présente une valeur valide.

• Vous pouvez utiliser l’outil Focal Statistics (Statistique focales) pour créer des filtres personnalisés pour votre spécification.

• 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

Boîte de dialogue

Étiquette	Explication	Type de données
Raster en entrée	Raster en entrée que vous souhaitez filtrer.	Raster Layer
Type de filtre (Facultatif)	Type de filtrage à effectuer. Passe-bas—Passe par un filtre passe-bas 3 x 3 dans le raster. Cette option permet de lisser tout le raster en entrée et de restreindre les anomalies au niveau des cellules. Il s’agit de l’option par défaut. Passe-haut—Passe par un filtre passe-haut 3 x 3 dans le raster. Cette option permet d'améliorer les tronçons des entités atténuées dans un raster.	String
Ignorer NoData dans les calculs (Facultatif)	Indique si des valeurs NoData ne sont pas prises en compte lors du filtrage. Activé : si une valeur NoData existe dans le filtre, elle n'est pas prise en compte. Seules les cellules du filtre associées à des valeurs de données sont utilisées pour calculer le résultat. Il s’agit de l’option par défaut. Désactivé : si une valeur NoData est présente dans le filtre, la sortie de la cellule de traitement sera 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

Étiquette	Explication	Type de données
Raster en sortie	Raster filtré en sortie. La sortie est toujours de type virgule flottante.	Raster

Python

Filter(in_raster, {filter_type}, {ignore_nodata})

Nom	Explication	Type de données
in_raster	Raster en entrée que vous souhaitez filtrer.	Raster Layer
filter_type (Facultatif)	Type de filtrage à effectuer. LOW—Passe par un filtre passe-bas 3 x 3 dans le raster. Cette option permet de lisser tout le raster en entrée et de restreindre les anomalies au niveau des cellules. Il s’agit de l’option par défaut. HIGH—Passe par un filtre passe-haut 3 x 3 dans le raster. Cette option permet d'améliorer les tronçons des entités atténuées dans un raster.	String
ignore_nodata (Facultatif)	Indique si des valeurs NoData ne sont pas prises en compte lors du filtrage. DATA—Si une valeur NoData existe dans le filtre, elle n'est pas prise en compte. Seules les cellules du filtre associées à des valeurs de données sont utilisées pour calculer le résultat. Il s’agit de l’option par défaut. NODATA—Si une valeur NoData est présente dans le filtre, la sortie de la cellule de traitement sera 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 filtré en sortie. La sortie est toujours de type virgule flottante.	Raster

Exemple de code

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

Dans cet exemple, on filtre (passe-haut) un raster en entrée.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
filterOut =  Filter("elevation", "HIGH", "DATA") 
filterOut.save("C:/sapyexamples/output/filtered")

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

Dans cet exemple, on filtre (passe-bas) un raster en entrée.

# Name: Filter_Ex_02.py
# Description: Performs a preset focal filter on a raster. 
# 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" 

# Execute Filter
filterOut =  Filter(inRaster, "LOW", "") 

# Save the output 
filterOut.save("C:/sapyexamples/output/filterout")

Environnements

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