Fließentfernung (Raster Analysis)—ArcGIS Pro

Zusammenfassung

Berechnet für jede Zelle die horizontale oder vertikale Komponente der Neigungsentfernung entlang den Fließpfaden zu Zellen des Wasserlaufs. Wenn mehrere Fließpfade vorhanden sind, können die minimale Fließentfernung, die gewichtete mittlere Fließentfernung bzw. die maximale Fließentfernung berechnet werden.

Wenn ein optionales Fließrichtungs-Raster angegeben wird, werden nur die Neigungsrichtungen berücksichtigt, die durch das Eingabe-Fließrichtungs-Raster definiert werden.

Abbildung

Verwendung

Dieses Portal-Werkzeug für die Raster-Analyse ist verfügbar, wenn Sie bei einem ArcGIS Enterprise -Portal mit einem konfigurierten ArcGIS Image Server für die Raster Analysis angemeldet sind. Beim Aufruf des Werkzeugs dient ArcGIS Pro als Client. Die Verarbeitung erfolgt auf den Servern, die mit ArcGIS Enterprise verbunden sind. Das Portal-Werkzeug akzeptiert Layer aus dem Portal als Eingabe und erstellt die Ausgabe im Portal.
Als Eingabe-Raster-Layer kann ein Layer aus dem Portal, ein URI bzw. eine URL zu einem Image-Service oder die Ausgabe des Werkzeugs Image Server-Layer erstellen verwendet werden. Lokale Raster-Daten oder -Layer werden von diesem Werkzeug nicht unterstützt.
Um die Neigungsrichtungen, an denen entlang die Fließentfernung gemessen wird, zu begrenzen, geben Sie ein optionales Eingabe-Fließrichtungs-Raster an, das mit dem Werkzeug Fließrichtung abgeleitet werden kann. Wählen Sie beim Generieren eines optionalen Eingabe-Fließrichtungs-Rasters unter den Modellen D8, D-Infinity (DINF) und Multiple Flow Direction (MFD) aus. Verwenden Sie den Eingabe-Fließrichtungstyp, um festzulegen, welche Methode beim Erstellen des Fließrichtungs-Rasters verwendet wurde.
Wenn ein optionales Eingabe-Fließrichtungs-Raster angegeben wird, wird empfohlen, dass dieses Raster mit dem Werkzeug Fließrichtung unter Verwendung desselben Eingabe-Oberflächen-Rasters, das Sie für das Werkzeug Fließentfernung bereitstellen, erstellt wird.

Wenn dieses Eingabe-Oberflächen-Raster frei von Senken ist, werden die Entfernungsmesswerte an Wasserlaufzellen übertragen, die durch das Eingabe-Wasserlauf-Raster dargestellt werden.
Wenn dieses Eingabe-Oberflächen-Raster Senken enthält, können einige Fließpfade abbrechen, indem sie in Senken fließen, bevor sie Wasserläufe erreichen. In solchen Fällen werden Fließentfernungsmesswerte für diese Zellen nur bis zu den Senkenzellen, in die sie fließen, berechnet.
Wird das Werkzeug ohne ein optionales Fließrichtungs-Raster ausgeführt, wird die Fließentfernung unter Berücksichtigung aller möglichen Neigungsfließpfade von jeder Zelle zu Zellen eines Wasserlaufs, in die sie fließen, beurteilt.
Wenn das Werkzeug mit einem optionalen D8-Fließrichtungs-Raster ausgeführt wird, dann gibt es nur einen möglichen Neigungsfließpfad von jeder Zelle zu einer Zelle des Wasserlaufs, und die Fließentfernung wird entlang dieses einen Fließpfades gemessen.
Es wird empfohlen, das Eingabe-Wasserlauf-Raster unter Verwendung desselben Eingabe-Oberflächen-Rasters, das als Eingabe für das Werkzeug bereitgestellt wurde, zu erstellen. Wenn Ihnen eine Erweiterungslizenz für Spatial Analyst zur Verfügung steht, können Sie Fluss-Raster aus einem Eingabe-Oberflächen-Raster mit den Werkzeugen Fließrichtung, Abflussakkumulation und If-Else-Bedingungen erstellen. Wenn Sie Wasserläufe aus anderen Datenquellen verwenden möchten, erhalten Sie die besten Ergebnisse, wenn Sie sie zuerst in das Eingabe-Oberflächen-Raster brennen und dann das Werkzeug Fließentfernung ausführen.
Wenn auf dem Weg von den einzelnen Zellen zu den Zellen in dem Strom, in den die Fließpfade münden, mehrere Fließpfade vorhanden sind, verwenden Sie Statistiktyp, um die minimale Fließentfernung, die gewichtete mittlere Fließentfernung oder die maximale Fließentfernung zu berechnen.
Wenn auf dem Weg von den einzelnen Zellen zu einer Zelle im Strom nur ein Fließpfad vorhanden ist, ergeben alle Statistiktypen dasselbe Ergebnis.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabe-Wasserlauf-Raster	Das Eingabe-Raster, das das Wasserlaufnetz definiert.	Raster Layer; Image Service; String
Eingabe-Oberflächen-Raster	Das Eingabe-Raster, das eine kontinuierliche Oberfläche darstellt.	Raster Layer; Image Service; String
Ausgabename	Der Name des Ausgabe-Fließentfernungs-Raster-Service. Der Standardname basiert auf dem Werkzeugnamen und dem Namen des Eingabe-Layers. Wenn der Layer-Name bereits vorhanden ist, werden Sie dazu aufgefordert, einen anderen Namen einzugeben.	String
Eingabe-Fließrichtungs-Raster (optional)	Das Eingabe-Raster, das die Fließrichtung aus jeder Zelle anzeigt. Wenn ein Fließrichtungs-Raster angegeben wird, werden nur die Neigungsrichtungen berücksichtigt, die durch die Eingabe-Fließrichtungen definiert werden. Das Fließrichtungs-Raster lässt sich mit den Methoden D8, MFD oder DINF erstellen. Verwenden Sie den Parameter Fließrichtungstyp, um anzugeben, welche Methode beim Erstellen des Fließrichtungs-Rasters verwendet wurde.	Raster Layer; Image Service; String
Entfernungstyp (optional)	Der zu berechnende Entfernungstyp. Vertikal—Die Fließentfernungsberechnungen ermitteln die vertikale Komponente der minimalen Fließentfernung entlang dem Fließpfad von jeder Zelle in der Domäne zu Zellen des Wasserlaufs, in die sie fließen. Dies ist die Standardeinstellung. Horizontal—Die Fließentfernungsberechnungen ermitteln die horizontale Komponente der minimalen Fließentfernung entlang dem Fließpfad von jeder Zelle in der Domäne zu Zellen des Wasserlaufs, in die sie fließen.	String
Fließrichtungstyp (optional)	Gibt den Typ des Eingabe-Fließrichtungs-Rasters an. D8—Das Eingabe-Fließrichtungs-Raster weist den Typ D8 auf. Dies ist die Standardeinstellung. MFD—Das Eingabe-Fließrichtungs-Raster weist den Typ Multi Flow Direction (MFD) auf. DINF—Das Eingabe-Fließrichtungs-Raster weist den Typ D-Infinity (DINF) auf.	String
Statistiktyp (optional)	Gibt den Statistiktyp an, der zum Berechnen der Fließentfernung über mehrere Fließpfade hinweg verwendet wird. Wenn auf dem Weg von den einzelnen Zellen zu einer Zelle im Strom nur ein Fließpfad vorhanden ist, ergeben alle Statistiktypen dasselbe Ergebnis. Minimum—Wenn mehrere Fließpfade vorhanden sind, wird die minimale Fließentfernung berechnet. Dies ist die Standardeinstellung. Gewichteter Mittelwert—Wenn mehrere Fließpfade vorhanden sind, wird ein gewichteter Mittelwert der Fließentfernung berechnet. Der Teil des Abflusses aus einer Zelle zu den flussabwärts gelegenen Nachbarzellen wird als Gewichtung für die Berechnung des gewichteten Mittelwerts verwendet. Maximum—Wenn mehrere Fließpfade vorhanden sind, wird die maximale Fließentfernung berechnet.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Raster	Das Ausgabe-Raster.	Raster-Layer

arcpy.ra.FlowDistance(inputStreamRaster, inputSurfaceRaster, outputName, {inputFlowDirectionRaster}, {distanceType}, {flowDirectionType}, {statisticsType})

Name	Erläuterung	Datentyp
inputStreamRaster	Das Eingabe-Raster, das das Wasserlaufnetz definiert.	Raster Layer; Image Service; String
inputSurfaceRaster	Das Eingabe-Raster, das eine kontinuierliche Oberfläche darstellt.	Raster Layer; Image Service; String
outputName	Der Name des Ausgabe-Fließentfernungs-Raster-Service. Der Standardname basiert auf dem Werkzeugnamen und dem Namen des Eingabe-Layers. Wenn der Layer-Name bereits vorhanden ist, werden Sie dazu aufgefordert, einen anderen Namen einzugeben.	String
inputFlowDirectionRaster (optional)	Das Eingabe-Raster, das die Fließrichtung aus jeder Zelle anzeigt. Wenn ein Fließrichtungs-Raster angegeben wird, werden nur die Neigungsrichtungen berücksichtigt, die durch die Eingabe-Fließrichtungen definiert werden. Das Fließrichtungs-Raster lässt sich mit den Methoden D8, MFD oder DINF erstellen. Verwenden Sie den Parameter flowDirectionType, um anzugeben, welche Methode beim Erstellen des Fließrichtungs-Rasters verwendet wurde.	Raster Layer; Image Service; String
distanceType (optional)	Der zu berechnende Entfernungstyp. VERTICAL—Die Fließentfernungsberechnungen ermitteln die vertikale Komponente der minimalen Fließentfernung entlang dem Fließpfad von jeder Zelle in der Domäne zu Zellen des Wasserlaufs, in die sie fließen. Dies ist die Standardeinstellung. HORIZONTAL—Die Fließentfernungsberechnungen ermitteln die horizontale Komponente der minimalen Fließentfernung entlang dem Fließpfad von jeder Zelle in der Domäne zu Zellen des Wasserlaufs, in die sie fließen.	String
flowDirectionType (optional)	Gibt den Typ des Eingabe-Fließrichtungs-Rasters an. D8—Das Eingabe-Fließrichtungs-Raster weist den Typ D8 auf. Dies ist die Standardeinstellung. MFD—Das Eingabe-Fließrichtungs-Raster weist den Typ Multi Flow Direction (MFD) auf. DINF—Das Eingabe-Fließrichtungs-Raster weist den Typ D-Infinity (DINF) auf.	String
statisticsType (optional)	Gibt den Statistiktyp an, der zum Berechnen der Fließentfernung über mehrere Fließpfade hinweg verwendet wird. Wenn auf dem Weg von den einzelnen Zellen zu einer Zelle im Strom nur ein Fließpfad vorhanden ist, ergeben alle Statistiktypen dasselbe Ergebnis. MINIMUM—Wenn mehrere Fließpfade vorhanden sind, wird die minimale Fließentfernung berechnet. Dies ist die Standardeinstellung. WEIGHTED_MEAN—Wenn mehrere Fließpfade vorhanden sind, wird ein gewichteter Mittelwert der Fließentfernung berechnet. Der Teil des Abflusses aus einer Zelle zu den flussabwärts gelegenen Nachbarzellen wird als Gewichtung für die Berechnung des gewichteten Mittelwerts verwendet. MAXIMUM—Wenn mehrere Fließpfade vorhanden sind, wird die maximale Fließentfernung berechnet.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
outputRaster	Das Ausgabe-Raster.	Raster-Layer

Codebeispiel

FlowDistance – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird die minimale horizontale Neigungsfließentfernung zu einer Zelle im Fluss-Raster berechnet.

import arcpy
arcpy.FlowDistance_ra("https://myserver/rest/services/streams/ImageServer","https://myserver/rest/services/elevation_fill/ImageServer","outFlowDistanceVertical1")

FlowDistance – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird die minimale vertikale Neigungsfließentfernung zu einer Zelle im Fluss-Raster berechnet.

#---------------------------------------------------------------------------
# Name: FlowDistance_example02.py
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inStreams = "https://myserver/rest/services/streams/ImageServer"
inSurface = "https://myserver/rest/services/elevation_fill/ImageServer"
outputFlowDistance = "outFlowDistanceVertical2"
inFlowDirection = ""
distanceType = "VERTICAL"

# Execute Flow Distance raster analysis tool
arcpy.FlowDistance_ra(inStreams, inSurface, outputFlowDistance, inFlowDirection, distanceType)

Zusammenfassung

Abbildung

Verwendung

Parameter

Abgeleitete Ausgabe

Abgeleitete Ausgabe

Codebeispiel

Umgebungen

Sonderfälle

Lizenzinformationen

Verwandte Themen

In diesem Thema