Filter (Spatial Analyst)

Zusammenfassung

Wendet entweder einen Glättungsfilter (Tiefpassfilter) oder einen Filter zur Kantenschärfung (Hochpassfilter) auf ein Raster an.

Weitere Informationen zur Funktionsweise des Werkzeugs "Filter"

Verwendung

  • Die Filteroption Tiefpass (LOW in Python) ist ein Mittelwertfilter (Glättungsfilter). Die Filteroption Hochpass (HIGH in Python) ist ein Filter zur Kantenschärfung.

  • NoData-Zellen in der Eingabe können einen Wert in der Ausgabe erhalten, wenn die Option NoData in Berechnungen ignorieren aktiviert ist (ignore_nodata in Python auf NODATA festgelegt), vorausgesetzt, dass mindestens eine Zelle in der Filternachbarschaft einen gültigen Wert aufweist.

  • Mit dem Werkzeug Focal Statistics können Sie benutzerdefinierte Filter gemäß Ihren Angaben erstellen.

  • Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das Eingabe-Raster, für das der Filtervorgang ausgeführt werden soll.

Raster Layer
Filtertyp
(optional)

Der Typ des durchzuführenden Filtervorgangs.

  • TiefpassDurchläuft einen 3x3-Tiefpassfilter über dem Raster. Diese Option glättet das gesamte Eingabe-Raster und reduziert die Signifikanz anomaler Zellen. Dies ist die Standardeinstellung.
  • HochpassDurchläuft einen 3x3-Hochpassfilter über dem Raster. Diese Option schärft die Kanten von gedämpften Features in einem Raster.
String
NoData-Werte in Berechnungen ignorieren
(optional)

Gibt an, ob NoData-Werte bei der Filterberechnung ignoriert werden.

  • Aktiviert – Wenn ein NoData-Wert im Filter vorhanden ist, wird der NoData-Wert ignoriert. Nur Zellen im Filter, die Datenwerte aufweisen, werden bei der Ermittlung der Ausgabe verwendet. Dies ist die Standardeinstellung.
  • Deaktiviert – Wenn ein NoData-Wert im Filter vorhanden ist, wird "NoData" für die bearbeitete Zelle ausgegeben. Bei Auswahl dieser Option bedeutet das Vorhandensein eines NoData-Wertes, dass nicht genügend Informationen verfügbar sind, um den statistischen Wert für die Nachbarschaft zu bestimmen.
Boolean

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das gefilterte Ausgabe-Raster.

Die Ausgabe ist immer im Gleitkommaformat.

Raster

Filter(in_raster, {filter_type}, {ignore_nodata})
NameErläuterungDatentyp
in_raster

Das Eingabe-Raster, für das der Filtervorgang ausgeführt werden soll.

Raster Layer
filter_type
(optional)

Der Typ des durchzuführenden Filtervorgangs.

  • LOWDurchläuft einen 3x3-Tiefpassfilter über dem Raster. Diese Option glättet das gesamte Eingabe-Raster und reduziert die Signifikanz anomaler Zellen. Dies ist die Standardeinstellung.
  • HIGHDurchläuft einen 3x3-Hochpassfilter über dem Raster. Diese Option schärft die Kanten von gedämpften Features in einem Raster.
String
ignore_nodata
(optional)

Gibt an, ob NoData-Werte bei der Filterberechnung ignoriert werden.

  • DATAWenn ein NoData-Wert im Filter vorhanden ist, wird der NoData-Wert ignoriert. Nur Zellen im Filter, die Datenwerte aufweisen, werden bei der Ermittlung der Ausgabe verwendet. Dies ist die Standardeinstellung.
  • NODATAWenn ein NoData-Wert im Filter vorhanden ist, wird "NoData" für die bearbeitete Zelle ausgegeben. Bei Auswahl dieser Option bedeutet das Vorhandensein eines NoData-Wertes, dass nicht genügend Informationen verfügbar sind, um den statistischen Wert für die Nachbarschaft zu bestimmen.
Boolean

Rückgabewert

NameErläuterungDatentyp
out_raster

Das gefilterte Ausgabe-Raster.

Die Ausgabe ist immer im Gleitkommaformat.

Raster

Codebeispiel

Filter – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird ein Hochpassfilter auf das Eingabe-Raster angewendet.

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")
Filter – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird ein Tiefpassfilter auf das Eingabe-Raster angewendet.

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