Wasserlauf an Raster anpassen (Spatial Analyst)—ArcGIS Pro

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Passt die Wasserlauf-Feature-Eingabe an, damit sie mit der Auflösung eines Eingabe-Rasters übereinstimmt.

Verwendung

Der Parameter Angepasste Ausgabe-Wasserlauf-Features (out_stream_features in Python) stellt die Wasserlauf-Features im Parameterwert Eingabe-Wasserlauf-Features (in_stream_features in Python) nach der Anpassung an die Auflösung des Parameterwertes Eingabe-Raster (in_raster in Python) dar.
Bei der Anpassung wird sichergestellt, dass der angepasste Wasserlauf jede überlappende Zelle im Parameterwert Eingabe-Raster an ihrem Mittelpunkt kreuzt, wobei der ursprüngliche Pfad des Wasserlaufes erhalten bleibt.
Mit dem optionalen Parameterwert Nach Feld gruppieren (group_by_field in Python) werden Wasserlaufsegmente basierend auf dem ausgewählten Feld gruppiert. Standardmäßig wird auf den Parameterwert Eingabe-Wasserlauf-Features keine Gruppierung angewendet, es sei denn, er enthält Wasserläufe, die in verschiedene Teile segmentiert wurden, aber zum gleichen Wasserlaufsegment gehören. In diesem Fall werden sie zusammengeführt, um sicherzustellen, dass jedes Wasserlaufsegment in der Ausgabe eine eindeutige ID erhält. Wenn mit den Feldwerten jedem Wasserlaufsegment eine eindeutige ID zugewiesen wird, erfolgt keine Gruppierung.
Eine Raster-Darstellung der angepassten Wasserläufe kann durch Angeben des Parameterwertes Angepasstes Ausgabe-Fluss-Raster (out_stream_raster in Python) gespeichert werden.
Der optionale Parameterwert Nach Feld gruppieren (group_by_field in Python) bestimmt die Zellwerte im Parameterwert Angepasstes Ausgabe-Fluss-Raster.
Die Fließrichtung des Wassers (D8) an jeder Zelle für die angepassten Wasserläufe kann durch Angeben des Parameterwertes Ausgabe-Fließrichtungs-Raster (out_flow_direction_raster in Python) gespeichert werden.
Mit dem Parameter Spitze Winkel entfernen (remove_sharp_angles in Python) können Sie sicherstellen, dass keine eine Zelle breiten Linien vorhanden sind, durch die im Parameterwert Angepasste Ausgabe-Fluss-Raster 90-Grad-Winkel entstehen.
Wenn erwartet wird, dass der Parameterwert Eingabe-Wasserlauf-Features (in_stream_features in Python) Positionen enthält, an denen ein Wasserlauf in zwei Wasserläufe geteilt wird und einer der Wasserläufe als Hauptkanal betrachtet wird, kann der Hauptkanal über den Parameter Divergierender Fluss oder nächstes Feld im Pfad (divergent_flow_or_next_field in Python) angegeben werden. In diesem Fall muss in der Attributtabelle für den Parameterwert Eingabe-Wasserlauf-Features (in_stream_features in Python) ein Feld namens HydroID vorhanden sein. Bei einem in zwei Wasserläufe geteilten Wasserlauf muss das ausgewählte Feld auf den HydroID des als Hauptkanal betrachteten Wasserlaufs verweisen.
Das Werkzeug kann maximal 2.147.483.647 (2^31 - 1) Wasserlauf-Features verarbeiten.
Die standardmäßige Analyseausdehnung entspricht der des Parameterwertes Eingabe-Wasserlauf-Features (in_stream_features in Python).
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabe-Wasserlauf-Features	Die Wasserlauf-Features, die an die Auflösung des Eingabe-Rasters angepasst werden sollen.	Feature Dataset
Eingabe-Raster	Das Raster, an das die Eingabe-Wasserlauf-Features angepasst werden sollen.	Raster Dataset
Angepasste Ausgabe-Wasserlauf-Features	Die unregelmäßige Darstellung der Eingabe-Wasserlauf-Features, die der Auflösung des Eingabe-Rasters entsprechen. Die Ausgabe-Wasserlauf-Features werden abhängig vom Parameterwert Nach Feld gruppieren gruppiert. Zusätzlich zum angegebenen Feld enthält die Attributtabelle gegebenenfalls auch das folgende Feld: StreamLink: Eine ID, die Wasserlauf-Abschnitten zugewiesen ist. Abschnitte sind die Bereiche eines Wasserlaufkanals, die zwei aufeinander folgende Knoten miteinander verbinden.	Feature Class
Nach Feld gruppieren (optional)	Das Feld mit den Werten, die zum Gruppieren der Wasserläufe in den Parameterwerten Angepasste Ausgabe-Wasserlauf-Features und Angepasstes Ausgabe-Fluss-Raster verwendet werden. Die Werte im Feld müssen ganze Zahlen sein.	Field
Spitze Winkel entfernen (optional)	Gibt an, ob spitze Winkel aus den Ausgabe-Wasserlauf-Features entfernt werden. Spitze Winkel werden durch Liniensegmente mit 90-Grad-Winkeln und einer Breite von einer Zelle dargestellt. Aktiviert: Alle Liniensegmente, die den Kriterien entsprechen, werden vereinfacht, und spitze Winkel werden aus der Ausgabe entfernt. Dies ist die Standardeinstellung. Deaktiviert: Liniensegmente werden nicht geändert, und spitze Winkel werden nicht aus der Ausgabe entfernt.	Boolean
Divergierender Fluss oder nächstes Feld im Pfad (optional)	Das Feld im Parameterwert Eingabe-Wasserlauf-Features, das den Hauptkanal nach einer Flussteilung angibt. Das Wasserlaufsegment, das dem Hauptkanal entspricht, muss mithilfe einer ID angegeben werden. Die ID muss vorhanden und in einem Feld namens HydroID enthalten sein.	Field
Angepasstes Ausgabe-Fluss-Raster (optional)	Die Raster-Version des Parameterwertes Angepasste Ausgabe-Wasserlauf-Features. Die Zellwerte entsprechen den Werten in dem im Parameterwert Nach Feld gruppieren angegebenen Feld.	Raster Dataset
Ausgabe-Fließrichtungs-Raster (optional)	Das Raster, in dem die Fließrichtung (D8) innerhalb der Wasserlaufzellen, die der Digitalisierrichtung der Eingabe-Wasserlauf-Features entsprechen, gespeichert wird.	Raster Dataset
Ausgabe-Teilungspunkt-Features (optional)	Die Positionen, an denen Flussteilungen auftreten, und ihre zugeordneten Konnektivitätsknoten in den angepassten Ausgabe-Wasserlauf-Features.	Feature Class

AdjustStreamToRaster(in_stream_features, in_raster, out_stream_features, {group_by_field}, {remove_sharp_angles}, {divergent_flow_or_next_field}, {out_stream_raster}, {out_flow_direction_raster}, {out_split_point_features})

Name	Erläuterung	Datentyp
in_stream_features	Die Wasserlauf-Features, die an die Auflösung des Eingabe-Rasters angepasst werden sollen.	Feature Dataset
in_raster	Das Raster, an das die Eingabe-Wasserlauf-Features angepasst werden sollen.	Raster Dataset
out_stream_features	Die unregelmäßige Darstellung der Eingabe-Wasserlauf-Features, die der Auflösung des Eingabe-Rasters entsprechen. Die Ausgabe-Wasserlauf-Features werden abhängig vom Parameterwert group_by_field gruppiert. Zusätzlich zum angegebenen Feld enthält die Attributtabelle gegebenenfalls auch das folgende Feld: StreamLink: Eine ID, die Wasserlauf-Abschnitten zugewiesen ist. Abschnitte sind die Bereiche eines Wasserlaufkanals, die zwei aufeinander folgende Knoten miteinander verbinden.	Feature Class
group_by_field (optional)	Das Feld mit den Werten, die zum Gruppieren der Wasserläufe in den Parameterwerten out_stream_features und out_stream_raster verwendet werden. Die Werte im Feld müssen ganze Zahlen sein.	Field
remove_sharp_angles (optional)	Gibt an, ob spitze Winkel aus den Ausgabe-Wasserlauf-Features entfernt werden. Spitze Winkel werden durch Liniensegmente mit 90-Grad-Winkeln und einer Breite von einer Zelle dargestellt. REMOVE—Alle Liniensegmente, die den Kriterien entsprechen, werden vereinfacht, und spitze Winkel werden aus der Ausgabe entfernt. Dies ist die Standardeinstellung. NO_REMOVE—Liniensegmente werden nicht geändert, und spitze Winkel werden nicht aus der Ausgabe entfernt.	Boolean
divergent_flow_or_next_field (optional)	Das Feld im Parameterwert in_stream_features, das den Hauptkanal nach einer Flussteilung angibt. Das Wasserlaufsegment, das dem Hauptkanal entspricht, muss mithilfe einer ID angegeben werden. Die ID muss vorhanden und in einem Feld namens HydroID enthalten sein.	Field
out_stream_raster (optional)	Die Raster-Version des Parameterwertes out_stream_features. Die Zellwerte entsprechen den Werten in dem im Parameterwert group_by_field angegebenen Feld.	Raster Dataset
out_flow_direction_raster (optional)	Das Raster, in dem die Fließrichtung (D8) innerhalb der Wasserlaufzellen, die der Digitalisierrichtung der Eingabe-Wasserlauf-Features entsprechen, gespeichert wird.	Raster Dataset
out_split_point_features (optional)	Die Positionen, an denen Flussteilungen auftreten, und ihre zugeordneten Konnektivitätsknoten in den angepassten Ausgabe-Wasserlauf-Features.	Feature Class

Codebeispiel

AdjustStreamToRaster: Beispiel 1 (Python-Fenster)

Dieses Beispiel veranschaulicht, wie Sie mit AdjustStreamToRaster der Auflösung eines Eingabe-Rasters entsprechende Wasserläufe ohne spitze Winkel generieren können. Die Ausgabe ist standardmäßig nicht gruppiert.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data.gdb"

AdjustStreamToRaster(in_stream_features="streams", 
                     in_raster="elevation", 
                     out_stream_features="out_stream_features", 
                     group_by_field="NONE",
                     remove_sharp_angles="REMOVE",
                     divergent_flow_or_next_field="NONE",
                     out_stream_raster="out_stream_raster",
                     out_flow_direction_raster="out_stream_flowdir_raster",
                     out_split_point_features=None
                     )

AdjustStreamToRaster: Beispiel 2 (eigenständiges Skript)

# Name: AdjustStreamToRaster_standalone.py
# Description: Adjust the input streams features to the resolution of the input raster. 
# No groupping specified, therefore, the result will have as many number of features as 
# there are stream segments.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set local variables
InStreamFeatures="streams.shp"
InRaster = "elevation.tif"
OutStreamFeatures = "out_adjusted_streams.shp"
OutStreamRaster = "out_adjusted_streams.tif"
OutFlowDirRaster = "out_streams_fdr.tif"

# Execute the tool
AdjustStreamToRaster(InStreamFeatures, 
                     InRaster, 
                     OutStreamFeatures, 
                     "NONE", 
                     "", 
                     "NONE", 
                     OutStreamRaster, 
                     OutFlowDirRaster, 
                     "")

Lizenzinformationen

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

Zusammenfassung

Verwendung

Parameter

Codebeispiel

Umgebungen

Lizenzinformationen

Verwandte Themen

In diesem Thema