Raster an Wasserlauf anpassen (Spatial Analyst Tools)

Zusammenfassung

Ändert die Zellenwerte eines Eingabe-Oberflächen-Rasters an angegebenen Positionen.

Verwendung

Der Parameterwert Ausgabe-Raster-Oberfläche (out_surface_raster in Python) enthält nur geänderte Zellenwerte entlang der Eingabepfade. Alle anderen Zellen behalten ihre ursprünglichen Werte aus dem Eingabe-Oberflächen-Raster bei.
Der Parameterwert Eingabe-Pfad-Features (in_path_features in Python) stellt die Positionen dar, an denen Zellwerte geändert werden. Es werden sowohl 2D- als auch 3D-Linien unterstützt. Wenn 2D-Linien angegeben werden, werden die Zellenwerte aus dem Eingabe-Oberflächen-Raster extrahiert und in den Stützpunkten der optionalen 3D-Ausgabe-Pfad-Features gespeichert. Wenn 3D-Linien angegeben werden, werden die Z-Werte der Stützpunkte zur Änderung der Zellenwerte verwendet.
Das Werkzeug verarbeitet jede Linie separat und verwendet für jede das gleiche Eingabe-Oberflächen-Raster.

Wenn sich zwei Linien überschneiden, hat die zuletzt verarbeitete Linie das stärkste Gewicht.

Wenn sich zwei Linien treffen (beispielsweise an einem Knoten), verarbeitet das Werkzeug diese nacheinander. Wenn es sich bei den Eingabe-Pfad-Features um 3D-Linien handelt und die an jedem Knoten gespeicherten Z-Werte nicht konsistent sind, wird durch den geänderten Zellenwert möglicherweise kein flussabwärts gerichteter Fluss gewährleistet.
Wenn der Parameter Änderungsmethode (modification_method in Python) auf die Option Alle (ALL in Python) festgelegt ist, verwendet das Werkzeug die Z-Werte aller verfügbaren Stützpunkte.

Die Anzahl der Stützpunkte muss nicht mit der Anzahl der Zellen unterhalb der Linie übereinstimmen. Stimmt die Anzahl nicht überein, führt das Werkzeug eine Interpolation durch. Stimmt die Anzahl überein, erfolgt keine Interpolation, und das Werkzeug passt jede Zelle entsprechend dem Z-Wert des jeweiligen Stützpunkts an.

Diese Methode nimmt keine Änderungen am Eingabe-Oberflächen-Raster vor, wenn der Parameterwert Eingabe-Pfad-Features mit dem Werkzeug Bruchlinien generieren generiert wurde und in beiden Werkzeugen dasselbe Höhenraster verwendet wird oder wenn es sich bei den Eingabe-Pfad-Features um eine 2D-Linie handelt, die dieselbe Anzahl an Stützpunkten aufweist wie die darunter liegenden Zellen.
Wenn für den Parameter Änderungsbreite (modification_width in Python) ein Wert angegeben wird, der größer ist als die Zellengröße der Analyse, durchbricht das Werkzeug den Pfad und erzeugt einen Kanal mit V-förmigem Querschnitt. Bei einer Breite mit Dezimalstellen (z. B. 1,5 Zellen) rundet das Werkzeug auf die nächste ganze Zahl auf.
Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter "Analyseumgebungen und Spatial Analyst".

Beschriftung	Erläuterung	Datentyp
Eingabe-Pfad-Features	Die Eingabe-Polylinien-Features, die die Positionen identifizieren, an denen die Zellenwerte geändert werden sollen. Bei der Eingabe kann es sich um eine 2D- oder 3D-Linie handeln.	Feature Layer
Eingabe-Oberflächen-Raster	Das Eingabe-Oberflächen-Raster.	Raster Layer
Ausgabe-Pfad-Features (Optional)	Eine 3D-Darstellung der Eingabe-Pfad-Features. Die Polylinien-Stützpunkte an jedem Zellenmittelpunkt des Wertes des Parameters Eingabe-Oberflächen-Raster enthalten dann die niedrigste Höhe innerhalb des Pfades als Z-Werte im 3D-Shape.	Feature Dataset
Änderungsmethode (Optional)	Gibt die Methode an, die zum Ändern der Zellenwerte des Oberflächen-Rasters verwendet werden soll. Endpunkte—Zum Interpolieren werden der Z-Wert des ersten und des letzten Stützpunkts verwendet. Dies ist die Standardeinstellung. Alle—Für die Änderung wird der Z-Wert aller verfügbaren Stützpunkt verwendet. Maximum—Zum Ändern aller Zellen unter dem Pfad wird der maximale Z-Wert unter allen Stützpunkten verwendet. Minimum—Zum Ändern aller Zellen unter dem Pfad wird der minimale Z-Wert unter allen Stützpunkten verwendet. Durchschnitt—Zum Ändern aller Zellen unter dem Pfad wird der durchschnittliche Z-Wert unter allen Stützpunkten berechnet und verwendet.	String
Änderungsbreite (Optional)	Die Breite des geänderten Pfades im Eingabe-Oberflächen-Raster. Standardmäßig ist dies die Zellengröße der Analyse. Der Kanal hat in diesem Fall einen V-förmigen Querschnitt.	Linear Unit
Endpunkte-Puffer (Optional)	Der Puffer, der am Anfang und am Ende der Eingabepfadlinie verwendet werden soll. Dieser Puffer gewährleistet einen glatten Übergang zwischen dem Oberflächen-Raster und dem Anfang und Ende der Pfadlinie.	Linear Unit

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Oberflächen-Raster	Das Ausgabe-Oberflächen-Raster, dessen Zellenwerte entlang der Eingabepfade geändert wurden.	Raster

AdjustRasterToStream(in_path_features, in_surface_raster, {out_path_features}, {modification_method}, {modification_width}, {endpoints_buffer})

Name	Erläuterung	Datentyp
in_path_features	Die Eingabe-Polylinien-Features, die die Positionen identifizieren, an denen die Zellenwerte geändert werden sollen. Bei der Eingabe kann es sich um eine 2D- oder 3D-Linie handeln.	Feature Layer
in_surface_raster	Das Eingabe-Oberflächen-Raster.	Raster Layer
out_path_features (Optional)	Eine 3D-Darstellung der Eingabe-Pfad-Features. Die Polylinien-Stützpunkte an jedem Zellenmittelpunkt des Wertes des Parameters `in_surface_raster` enthalten dann die niedrigste Höhe innerhalb des Pfades als Z-Werte im 3D-Shape.	Feature Dataset
modification_method (Optional)	Gibt die Methode an, die zum Ändern der Zellenwerte des Oberflächen-Rasters verwendet werden soll. `ENDPOINTS`—Zum Interpolieren werden der Z-Wert des ersten und des letzten Stützpunkts verwendet. Dies ist die Standardeinstellung. `ALL`—Für die Änderung wird der Z-Wert aller verfügbaren Stützpunkt verwendet. `MAXIMUM`—Zum Ändern aller Zellen unter dem Pfad wird der maximale Z-Wert unter allen Stützpunkten verwendet. `MINIMUM`—Zum Ändern aller Zellen unter dem Pfad wird der minimale Z-Wert unter allen Stützpunkten verwendet. `AVERAGE`—Zum Ändern aller Zellen unter dem Pfad wird der durchschnittliche Z-Wert unter allen Stützpunkten berechnet und verwendet.	String
modification_width (Optional)	Die Breite des geänderten Pfades im Eingabe-Oberflächen-Raster. Standardmäßig ist dies die Zellengröße der Analyse. Der Kanal hat in diesem Fall einen V-förmigen Querschnitt.	Linear Unit
endpoints_buffer (Optional)	Der Puffer, der am Anfang und am Ende der Eingabepfadlinie verwendet werden soll. Dieser Puffer gewährleistet einen glatten Übergang zwischen dem Oberflächen-Raster und dem Anfang und Ende der Pfadlinie.	Linear Unit

Rückgabewert

Name	Erläuterung	Datentyp
out_surface_raster	Das Ausgabe-Oberflächen-Raster, dessen Zellenwerte entlang der Eingabepfade geändert wurden.	Raster

Codebeispiel

AdjustRasterToStream Beispiel 1 (Python-Fenster)

In diesem Beispiel wird mit den Standardparameterwerten ein geändertes Oberflächen-Raster entlang der Eingabe-Wasserläufe generiert.

from arcpy.sa import *
out_modified_surface = AdjustRasterToStream("in_breach_lines", 
                                             "surface.tif", 
                                             None, 
                                             "ENDPOINTS", 
                                             "", 
                                             "")
out_modified_surface.save("C:/arcpyExamples/outputs/" \
                            "out_modified_surface.tif")

AdjustRasterToStream Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird mithilfe des minimalen Z-Werts aller Stützpunkte ein geändertes Oberflächen-Raster entlang der Eingabe-Wasserläufe generiert.

# Name: AdjustRasterToStream_standalone.py
# Description: Adjusts the cell values of a surface raster along the input 2D stream 
# or lines to the minimum Z value across all the vertices. 
# Additionally, it creates an output shapefile representing the input streams in 3D.
# Requirements: Spatial Analyst extension

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

# Set the analysis environments
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set the local variables
in_path_features = "breachlines.shp"
in_surface_raster = "surface.tif"
out_3d_path_features = "breachlines_3D.shp"

# Run Adjust Raster to Stream
out_surface_raster = AdjustRasterToStream(in_path_features, 
                                           in_surface_raster, 
                                           out_3d_path_features, 
                                           "MIN", 
                                           "", 
                                           "")

# Save the output
out_surface_raster.save("C:/arcpyExamples/outputs/out_modified_surface.tif")

Umgebungen

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

Lizenzierungsinformationen

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

Raster an Wasserlauf anpassen (Spatial Analyst Tools)

Zusammenfassung

Verwendung

Parameter

Rückgabewert

Umgebungen

Lizenzierungsinformationen

Verwandte Themen