Abflusspunkt zuordnen (Spatial Analyst)

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 Abflussgebiet wird das Werkzeug Abflusspunkt zuordnen verwendet, um die Auswahl der Punkte mit hoher Abflussakkumulation sicherzustellen. Abflusspunkt 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 ganzzahliges 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).

  • 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})
ParameterErklärungDatentyp
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)

Das Feld für die Zuweisung von Werten zu den Abflusspunktpositionen.

Wenn das Abflusspunkt-Dataset ein Raster ist, verwenden Sie Value.

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

NameErklärungDatentyp
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 Abflusspunkte 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 Abflusspunkte 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"

# Execute SnapPourPoints
outSnapPour = SnapPourPoint(inPourPoint, inFlowAccum, tolerance, 
                            pourField) 

# Save the output 
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt02")

Lizenzinformationen

  • Basic: Erfordert Spatial Analyst
  • Standard: Erfordert Spatial Analyst
  • Advanced: Erfordert Spatial Analyst

Verwandte Themen