Fließlänge (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Berechnet die Entfernung flussaufwärts bzw. flussabwärts oder die kostengewichtete Entfernung entlang des Fließpfades für jede Zelle.

Verwendung

  • Eine primäre Verwendung des Werkzeugs Fließlänge besteht in der Berechnung der Länge des längsten Fließpfades innerhalb eines gegebenen Wassereinzugsgebiets. Dieser Messwert wird häufig verwendet, um die Konzentrationszeit eines Einzugsgebiets zu berechnen. Dazu wird die Option Flussaufwärts verwendet.

    Das Werkzeug kann auch verwendet werden, um Entfernungs-Flächen-Diagramme für hypothetische Niederschlags- und Abflussereignisse zu erstellen, wobei das Gewichtungs-Raster als Impedanz für die Abwärtsbewegung verwendet wird.

  • Der Wertetyp für das Fließlänge-Ausgabe-Raster ist Gleitkomma.

  • Wenn das Ausgabe-Raster-Format .crf lautet, wird in diesem Werkzeug die Raster-Speicherumgebung Pyramide unterstützt. In der Ausgabe werden standardmäßig Pyramiden erstellt. Bei anderen Ausgabeformaten wird diese Umgebung nicht unterstützt, und es werden keine Pyramiden erstellt.

  • Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Fließrichtungs-Raster

Das Eingabe-Raster, das die Fließrichtung aus jeder Zelle anzeigt.

Das Fließrichtungs-Raster kann mit dem Werkzeug Fließrichtung erstellt werden.

Raster Layer
Messrichtung
(optional)

Die Messrichtung entlang des Fließpfades.

  • FlussabwärtsBerechnet die Abstiegsentfernung entlang des Fließpfades, von jeder Zelle zu einer Senke oder einem Abfluss am Rand des Rasters.
  • FlussaufwärtsBerechnet die längste Aufstiegsentfernung entlang des Fließpfades, von jeder Zelle bis zur Spitze der Wasserscheide.
String
Eingabe-Gewichtungs-Raster
(optional)

Ein optionales Eingabe-Raster zum Anwenden einer Gewichtung auf jede Zelle.

Wenn kein Gewichtungs-Raster angegeben wird, wird eine Standardgewichtung von 1 auf jede Zelle angewendet. Das Ergebnis für jede Zelle im Ausgabe-Raster entspricht der Anzahl von Zellen, die in dieses Raster fließen.

Raster Layer

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster, das für jede Zelle die Aufstiegs- oder Abstiegsentfernung entlang eines Fließpfades anzeigt.

Raster

FlowLength(in_flow_direction_raster, {direction_measurement}, {in_weight_raster})
NameErläuterungDatentyp
in_flow_direction_raster

Das Eingabe-Raster, das die Fließrichtung aus jeder Zelle anzeigt.

Das Fließrichtungs-Raster kann mit dem Werkzeug Fließrichtung erstellt werden.

Raster Layer
direction_measurement
(optional)

Die Messrichtung entlang des Fließpfades.

  • DOWNSTREAMBerechnet die Abstiegsentfernung entlang des Fließpfades, von jeder Zelle zu einer Senke oder einem Abfluss am Rand des Rasters.
  • UPSTREAMBerechnet die längste Aufstiegsentfernung entlang des Fließpfades, von jeder Zelle bis zur Spitze der Wasserscheide.
String
in_weight_raster
(optional)

Ein optionales Eingabe-Raster zum Anwenden einer Gewichtung auf jede Zelle.

Wenn kein Gewichtungs-Raster angegeben wird, wird eine Standardgewichtung von 1 auf jede Zelle angewendet. Das Ergebnis für jede Zelle im Ausgabe-Raster entspricht der Anzahl von Zellen, die in dieses Raster fließen.

Raster Layer

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster, das für jede Zelle die Aufstiegs- oder Abstiegsentfernung entlang eines Fließpfades anzeigt.

Raster

Codebeispiel

FlowLength: Beispiel 1 (Python-Fenster)

In diesem Beispiel wird für jede Zelle die Entfernung flussaufwärts bzw. flussabwärts oder die kostengewichtete Entfernung entlang des Fließpfades berechnet.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFlowLength = FlowLength("flowdir", "DOWNSTREAM", "")
outFlowLength.save("c:/sapyexamples/output/outflowlen01")
FlowLength: Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird für jede Zelle die Entfernung flussaufwärts bzw. flussabwärts oder die kostengewichtete Entfernung entlang des Fließpfades berechnet.

# Name: _Ex_02.py
# Description: 
# 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
inFlowDirectionRaster = "flowdir"
inWeightRaster = ""
directionType = "DOWNSTREAM"

# Execute 
outFlowLength = FlowLength(inFlowDirectionRaster, directionType, inWeightRaster)

# Save the output 
outFlowLength.save("c:/sapyexamples/output/outflowlen02.tif")

Lizenzinformationen

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

Verwandte Themen