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

ÉtiquetteExplicationType 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-basPasse 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-hautPasse 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

ÉtiquetteExplicationType de données
Raster en sortie

Raster filtré en sortie.

La sortie est toujours de type virgule flottante.

Raster

Filter(in_raster, {filter_type}, {ignore_nodata})
NomExplicationType de données
in_raster

Raster en entrée que vous souhaitez filtrer.

Raster Layer
filter_type
(Facultatif)

Type de filtrage à effectuer.

  • LOWPasse 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.
  • HIGHPasse 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.

  • DATASi 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.
  • NODATASi 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

NomExplicationType 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")

Rubriques connexes