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 zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
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ärts—Berechnet die Abstiegsentfernung entlang des Fließpfades, von jeder Zelle zu einer Senke oder einem Abfluss am Rand des Rasters. Flussaufwärts—Berechnet 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

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

Python

FlowLength(in_flow_direction_raster, {direction_measurement}, {in_weight_raster})

Name	Erläuterung	Datentyp
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. DOWNSTREAM—Berechnet die Abstiegsentfernung entlang des Fließpfades, von jeder Zelle zu einer Senke oder einem Abfluss am Rand des Rasters. UPSTREAM—Berechnet 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

Name	Erläuterung	Datentyp
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")

Umgebungen

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