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.
Syntax
arcpy.ra.FlowDistance(inputStreamRaster, inputSurfaceRaster, outputName, {inputFlowDirectionRaster}, {distanceType}, {flowDirectionType}, {statisticsType})| Parameter | Erklärung | 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.
| String |
flowDirectionType (optional) | Gibt den Typ des Eingabe-Fließrichtungs-Rasters an.
| 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.
| String |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| outputRaster | Das Ausgabe-Raster. | Raster-Layer |
Codebeispiel
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")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)Umgebungen
Lizenzinformationen
- Basic: Erfordert ArcGIS Image Server
- Standard: Erfordert ArcGIS Image Server
- Advanced: Erfordert ArcGIS Image Server