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

ÉtiquetteExplicationType 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 avalCalcule 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 amontCalcule 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

ÉtiquetteExplicationType 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

FlowLength(in_flow_direction_raster, {direction_measurement}, {in_weight_raster})
NomExplicationType 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.

  • DOWNSTREAMCalcule 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.
  • UPSTREAMCalcule 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

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

Rubriques connexes