Disponible avec une licence Spatial Analyst.
Résumé
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 Longueur d'écoulement 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 cela, vous devez employer l'option UPSTREAM.
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 Longueur d'écoulement est à virgule flottante.
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.
Syntaxe
FlowLength(in_flow_direction_raster, {direction_measurement}, {in_weight_raster})
Paramètre | 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.
| 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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute
outFlowLength = FlowLength(inFlowDirectionRaster, directionType, inWeightRaster)
# Save the output
outFlowLength.save("c:/sapyexamples/output/outflowlen02.tif")
Environnements
Informations de licence
- Basic: Requiert Spatial Analyst
- Standard: Requiert Spatial Analyst
- Advanced: Requiert Spatial Analyst