Distance de flux (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Permet de calculer la distance en amont ou en aval, ou la distance pondérée, le long du chemin de flux pour chaque cellule.

Utilisation

• L'outil Distance de flux permet essentiellement de calculer la longueur du chemin de flux le plus long dans un bassin donné. Cette mesure permet souvent de calculer le temps de concentration d'un bassin. Pour ce faire, on utilise l’option Upstream (En amont).

  Vous pouvez également employer cet outil pour créer des diagrammes représentant les distances-surfaces relatives aux précipitations et aux écoulements prévisionnels, à l'aide d'un raster de pondération sous la forme d'une impédance en rapport avec le mouvement en aval.

• Le type de valeur pour le raster en sortie Distance de flux est à virgule flottante.

• Lorsque le format raster en sortie est .crf, cet outil prend en charge l’environnement de stockage raster Pyramide. Des pyramides seront créées dans la sortie par défaut. Pour tout autre format en sortie, cet environnement n’est pas pris en charge et aucune pyramide n’est créée.

• Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster de direction de flux en entrée	Raster en entrée qui montre la direction du flux sortant de chaque cellule. Le raster de direction de flux peut être créé à l’aide de l’outil Direction de flux.	Raster Layer
Direction de mesure (Facultatif)	Direction mesurée le long du chemin de flux. En aval—Calcule la distance de pente le long du chemin de flux depuis chaque cellule jusqu'à une cuvette ou un orifice sur le tronçon du raster. En amont—Calcule la distance de montée la plus grande le long du chemin de flux, depuis chaque cellule jusqu'à la ligne de partage des eaux.	String
Raster de pondération en entrée (Facultatif)	Raster en entrée facultatif pour appliquer une pondération à chaque cellule. Si aucun raster de pondération n'est spécifié, une pondération par défaut de 1 est appliquée à chaque cellule. Pour chaque cellule du raster en sortie, le résultat est le nombre de cellules arrivant dans la cellule.	Raster Layer

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Raster en sortie qui indique pour chaque cellule la distance en amont ou en aval le long d'un chemin de flux.	Raster

Python

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

Nom	Explication	Type de données
in_flow_direction_raster	Raster en entrée qui montre la direction du flux sortant de chaque cellule. Le raster de direction de flux peut être créé à l’aide de l’outil Direction de flux.	Raster Layer
direction_measurement (Facultatif)	Direction mesurée le long du chemin de flux. DOWNSTREAM—Calcule la distance de pente le long du chemin de flux depuis chaque cellule jusqu'à une cuvette ou un orifice sur le tronçon du raster. UPSTREAM—Calcule la distance de montée la plus grande le long du chemin de flux, depuis chaque cellule jusqu'à la ligne de partage des eaux.	String
in_weight_raster (Facultatif)	Raster en entrée facultatif pour appliquer une pondération à chaque cellule. Si aucun raster de pondération n'est spécifié, une pondération par défaut de 1 est appliquée à chaque cellule. Pour chaque cellule du raster en sortie, le résultat est le nombre de cellules arrivant dans la cellule.	Raster Layer

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Raster en sortie qui indique pour chaque cellule la distance en amont ou en aval le long d'un chemin de flux.	Raster

Exemple de code

Premier exemple d'utilisation de l'outil FlowLength (fenêtre Python)

Cet exemple décrit le calcul de la distance en aval le long du chemin de flux pour chaque cellule.

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")

Deuxième exemple d'utilisation de l'outil FlowLength (script autonome)

Cet exemple décrit le calcul de la distance en aval le long du chemin de flux pour chaque cellule.

# 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")

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Espace de travail courant, Étendue, Transformations géographiques, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Pyramide, Espace de travail temporaire, Raster de capture, Taille de tuile