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.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster oder -Features mit Abflusspunktdaten	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
Eingabe-Akkumulations-Raster	Das Eingabe-Raster für die Flussakkumulation. Kann mit dem Werkzeug Abflussakkumulation erstellt werden.	Raster Layer
Fangentfernung	Maximale Entfernung (in Karteneinheiten), in der nach einer Zelle mit höherer Abflussakkumulation gesucht werden soll.	Double
Abflusspunkt-Feld (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

Beschriftung	Erläuterung	Datentyp
Ausgabe-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

Python

SnapPourPoint(in_pour_point_data, in_accumulation_raster, snap_distance, {pour_point_field})

Name	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)	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

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 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")

Umgebungen

Auto-Commit, Zellengröße, Projektionsmethode für Zellengröße, Komprimierung, Aktueller Workspace, Ausdehnung, Geographische Transformationen, Maske, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Scratch-Workspace, Fang-Raster, Kachelgröße

Sonderfälle

Lizenzinformationen

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