Pourpoint zuordnen (Spatial Analyst)
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 als Standardfeld verwendet (z. B. OID oder FID).
Syntax
| 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-Ganzzahl-Raster für die Abflusspunkte, bei dem die ursprünglichen Abflusspunktpositionen an Positionen mit höherer Abflussakkumulation gefangen wurden. | Raster |
Codebeispiel
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")
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")