Fill (Spatial Analyst)
Zusammenfassung
Füllt Senken in einem Oberflächen-Raster, um alle Unregelmäßigkeiten in den Daten zu entfernen.
Weitere Informationen zur Funktionsweise des Werkzeugs "Fill"
Verwendung
-
Eine Senke ist eine Zelle mit einer nicht definierten Drainagerichtung; keine Zelle, die es umgeben, ist niedriger. Der Abflusspunkt ist die Grenzzelle mit der niedrigsten Höhe für die beteiligte Fläche einer Senke. Wenn die Senke mit Wasser gefüllt wurde, ist dies die Stelle, an der das Wasser ausströmen würde.
-
Das Z-Limit gibt die maximale Tiefe einer Senke an, die gefüllt wird. Das Z-Limit ist nicht die maximale Tiefe, bis zu der einer Senke gefüllt wird. Z-Limit muss größer als null sein.
-
Alle Senken, die unter dem Z-Limit liegen, also niedriger als ihr niedrigster angrenzender Nachbar, werden bis zur Höhe ihrer Abflusspunkte gefüllt.
-
Da das Werkzeug Fill iterativ ist, kann es CPU- und speicherplatzintensiv sein. Es kann bis zu viermal so viel Speicherplatz erfordern wie das Eingabe-Raster.
-
Die Verarbeitungsdauer hängt davon ab, wie viele Senken, mit dem Z-Limit gefunden wurden. Je mehr Senken, desto länger die Verarbeitungszeit.
-
Das Werkzeug Sink kann verwendet werden, um die Anzahl der Senken zu suchen, und zur Ermittlung ihrer Tiefe beitragen. Wenn die Tiefe der Senken bekannt ist, lässt sich leichter ein geeignetes Z-Limit für Fill bestimmen.
-
Fill kann verwendet werden, um Spitzen entfernen. Eine Spitze ist eine Zelle, bei der keine benachbarte Zelle höher ist. Um Spitzen zu entfernen, muss das Eingabeoberflächen-Raster umgekehrt werden. Dies kann mit dem Werkzeug Minus erledigt werden. Geben Sie den höchsten Wert des Oberflächen-Rasters als erste Eingabe für Minus und das Oberflächen-Raster als zweite Eingabe an. Führen Sie eineFill aus. Kehren Sie die Ergebnisse um, um eine Oberfläche zu erhalten, die die ursprünglichen Oberflächen-Raster-Werte unter Entfernung der Spitzen aufweist. Das Z-Limit kann ebenfalls auf diesen Prozess angewendet werden. Wenn kein Wert für das Z-Limit angegeben wird, werden alle Spitzen entfernt. Wenn ein Wert angegeben wird, werden keine Spitzen entfernt, bei denen die Differenz beim Z-Wert zwischen der Spitze und ihrem höchsten angrenzenden Nachbarn größer ist als das Z-Limit.
Syntax
Parameter | Erläuterung | Datentyp |
in_surface_raster | Das Eingabe-Raster, das eine kontinuierliche Oberfläche darstellt. | Raster Layer |
z_limit (optional) | Maximaler Höhenunterschied zwischen einer Senke und seinem Abflusspunkt, der gefüllt werden soll. Wenn die Differenz beim Z-Wert zwischen einer Senke und seinem Abflusspunkt größer als das Z-Limit ist, wird die betreffende Senke nicht gefüllt. Laut Standardvorgabe werden alle Senken, unabhängig von ihrer Tiefe, gefüllt. | Double |
Rückgabewert
Name | Erläuterung | Datentyp |
out_surface_raster |
Das Ausgabeoberflächen-Raster, nachdem die Senken gefüllt wurden. | Raster |
Codebeispiel
In diesem Beispiel werden die Senken eines Eingabe-GRID-Rasters für die Höhenoberflächen gefüllt.
import arcpy from arcpy import env from arcpy.sa import * env.workspace = "C:/sapyexamples/data" outFill = Fill("elevation") outFill.save("C:/sapyexamples/output/outfill01")
In diesem Beispiel werden die Senken eines Eingabe-GRID-Rasters für die Höhenoberflächen unter Anwendung eines Z-Limits gefüllt.
# Name: Fill_Ex_02.py # Description: Fills sinks in a surface 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 inSurfaceRaster = "elevation" zLimit = 3.28 # Check out the ArcGIS Spatial Analyst extension license arcpy.CheckOutExtension("Spatial") # Execute FlowDirection outFill = Fill(inSurfaceRaster, zLimit) # Save the output outFill.save("C:/sapyexamples/output/outfill02")