Mit der Spatial Analyst-Lizenz verfügbar.
Zusammenfassung
Fängt Fließpunkte an der Zelle mit der höchsten Abflussakkumulation innerhalb einer bestimmten Entfernung.
Verwendung
Beim Abgrenzen von Wassereinzugsgebieten mit dem Werkzeug Wasserscheide wird das Werkzeug Pourpoint zuordnen verwendet, um die Auswahl der Punkte mit hoher Abflussakkumulation sicherzustellen. Pourpoint zuordnen sucht innerhalb einer Fangentfernung um die angegebenen Abflusspunkte nach der Zelle mit der höchsten Abflussakkumulation und verschiebt den Abflusspunkt an diese Position.
Wenn es sich bei den Eingabe-Abflusspunktdaten um eine Point-Feature-Class handelt, wird diese zur Verarbeitung intern in ein Raster konvertiert.
Die Ausgabe ist ein Ganzzahl-Raster, wenn die ursprünglichen Abflusspunktpositionen an Positionen mit höherer Abflussakkumulation gefangen wurden.
Wenn es in der Eingabe nur eine einzige Abflusspunktposition gibt, entspricht die Ausdehnung der Ausgabe des Akkumulations-Rasters. Wenn es mehrere Abflusspunktpositionen gibt, richtet sich die Ausdehnung der Ausgabe nach den Einstellungen in der Umgebung Ausgabeausdehnung.
Beim Festlegen der Abflusspunktpositionen der Eingabe als Feature-Daten entspricht das Standardfeld dem ersten gültigen Feld. Sind keine gültigen Felder vorhanden, wird das ObjectID-Feld (z. B. OID oder FID) als Standardfeld verwendet.
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Syntax
SnapPourPoint (in_pour_point_data, in_accumulation_raster, snap_distance, {pour_point_field})| Parameter | Erläuterung | Datentyp |
in_pour_point_data | Die Abflusspunktpositionen der Eingabe, die gefangen werden sollen. Bei einer Raster-Eingabe werden alle Zellen, bei denen sich nicht um NoData-Zellen handelt (die also einen Wert aufweisen), als Abflusspunkte angesehen und gefangen. Bei einer Punkt-Feature-Eingabe werden die Positionen der Zellen angegeben, die gefangen werden. | Raster Layer | Feature Layer |
in_accumulation_raster | Das Eingabe-Raster für die Flussakkumulation. Kann mit dem Werkzeug Abflussakkumulation erstellt werden. | Raster Layer |
snap_distance | Maximale Entfernung (in Karteneinheiten), in der nach einer Zelle mit höherer Abflussakkumulation gesucht werden soll. | Double |
pour_point_field (optional) | Feld für die Zuweisung von Werten zu den Abflusspunktpositionen. Wenn das Abflusspunkt-Dataset ein Raster ist, verwenden Sie "Wert". Wenn das Abflusspunkt-Dataset ein Feature ist, verwenden Sie ein Zahlenfeld. Wenn das Feld Gleitkommawerte enthält, werden sie in Ganzzahlwerte gekürzt. | Field |
Rückgabewert
| Name | Erläuterung | Datentyp |
| out_raster | Das Ausgabe-Raster für die Abflusspunkte, bei dem die ursprünglichen Abflusspunktpositionen an Positionen mit höherer Abflussakkumulation gefangen wurden. Diese Ausgabe ist immer ganzzahlig. | Raster |
Codebeispiel
SnapPourPoint – Beispiel 1 (Python-Fenster)
Bei diesem Beispiel werden Fließpunkte an der Zelle mit der höchsten Abflussakkumulation innerhalb einer bestimmten Entfernung gefangen.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outSnapPour = SnapPourPoint("pourpoint", "flowaccumulation.img", 5,"VALUE")
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt01")
SnapPourPoint – Beispiel 2 (eigenständiges Skript)
Bei diesem Beispiel werden Fließpunkte an der Zelle mit der höchsten Abflussakkumulation innerhalb einer bestimmten Entfernung gefangen.
# Name: SnapPourPoints_Ex_02.py
# Description: Snaps pour points to the cell of highest
# flow accumulation within a specified distance.
# 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
inPourPoint = "pourpoint"
inFlowAccum = "flowaccumulation.img"
tolerance = 5
pourField = "VALUE"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute SnapPourPoints
outSnapPour = SnapPourPoint(inPourPoint, inFlowAccum, tolerance,
pourField)
# Save the output
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt02")
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Erfordert Spatial Analyst
- ArcGIS for Desktop Standard: Erfordert Spatial Analyst
- ArcGIS for Desktop Advanced: Erfordert Spatial Analyst