Mit der Spatial Analyst-Lizenz verfügbar.
Zusammenfassung
Erstellt ein Raster, das alle Wassereinzugsgebiete abgrenzt.
Verwendung
Die Wassereinzugsgebiete werden innerhalb des Analysefensters abgegrenzt, indem Bergkämme zwischen Einzugsgebieten identifiziert werden. Das Eingabefließrichtungs-Raster wird analysiert, um alle Gruppen verbundener Zellen zu suchen, die zum selben Wassereinzugsgebiet gehören. Die Wassereinzugsgebiete werden erstellt, indem die Abflusspunkte an den Kanten des Analysefensters, (wo Wasser aus dem Raster strömen würde) sowie Senken ermittelt werden und dann die beteiligte Fläche über jedem Abflusspunkt identifiziert wird. Dies führt zu einem Raster von Wassereinzugsgebieten.
Die besten Ergebnisse werden erzielt, wenn bei der Erstellung des Eingabe-Fließrichtungs-Rasters die Option Abfluss von Randzellen nach außen erzwingen (FORCE in Python) aktiviert wurde.
Alle Zellen im Raster gehören zu einem Einzugsgebiet, selbst wenn dieses Einzugsgebiet nur eine einzige Zelle umfasst.
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Syntax
Basin (in_flow_direction_raster)
| Parameter | Erläuterung | Datentyp |
in_flow_direction_raster | Das Eingabe-Raster, das die Fließrichtung aus jeder Zelle anzeigt. Das Fließrichtungs-Raster kann mit dem Werkzeug Fließrichtung erstellt werden. | Raster Layer |
Rückgabewert
| Name | Erläuterung | Datentyp |
| out_raster | Das Ausgabe-Raster, das die Wassereinzugsgebiete abgrenzt. Diese Ausgabe ist immer ganzzahlig. | Raster |
Codebeispiel
Basin – Beispiel 1 (Python-Fenster)
In diesem Beispiel werden die Wassereinzugsgebiete eines Eingabe-Fließrichtungs-Grid-Rasters bestimmt.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outBasin = Basin("flowdir")
outBasin.save("C:/sapyexamples/output/outbasin01")
Basin – Beispiel 2 (eigenständiges Skript)
In diesem Beispiel werden die Wassereinzugsgebiete eines Eingabe-Fließrichtungs-Grid-Rasters bestimmt.
# Name: Basin_Ex_02.py
# Description: Creates a raster delineating all drainage basins.
# 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
inFlowDirectionRaster = "flowdir"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute FlowDirection
outBasin = Basin(inFlowDirectionRaster)
# Save the output
outBasin.save("C:/sapyexamples/output/outbasin02")
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Erfordert Spatial Analyst
- ArcGIS for Desktop Standard: Erfordert Spatial Analyst
- ArcGIS for Desktop Advanced: Erfordert Spatial Analyst