Distance d'écoulement (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Calcule, pour chaque cellule, la composante horizontale ou verticale de la distance de pente descendante le long des chemins de flux, jusqu’aux cellules de cours d’eau dans lequel ils se déversent. Dans le cas de plusieurs chemins de flux, il est possible de calculer la moyenne pondérée minimum ou la distance d’écoulement maximum.

Si un raster de direction de flux facultatif est fourni, les directions de pente descendante seront limitées à celles définies par le raster de direction de flux en entrée.

Illustration

Illustration de l’outil Distance d’écoulement

Utilisation

  • Pour limiter les directions de pente descendante le long desquelles la distance d’écoulement est mesurée, fournissez un raster de sens de circulation en entrée facultatif qui peut être dérivé à l’aide de l’outil Direction de flux. Choisissez entre les modèles de flux D8, DINF (D-Infinity) et MFD (multi flow direction) tout en générant un raster de direction de flux en entrée facultatif. Utilisez Input flow direction type (Type de direction de flux en entrée) pour spécifier la méthode utilisée lors de la création du raster de direction de flux.

  • Si un raster de direction de flux en entrée facultatif est fourni, il est recommandé de créer ce raster à l'aide de l’outil Direction de flux avec le même raster de surface en entrée que celui que vous allez fournir à l’outil Distance d'écoulement.

    Si ce raster de surface en entrée ne comporte aucune cuvette, les mesures de distance s’étendent aux cellules d’écoulement représentées par le raster d’écoulement en entrée.

    Si ce raster de surface en entrée possède des cuvettes, certains chemins de flux peuvent être raccourcis en s’écoulant dans des cuvettes avant d’atteindre des écoulements. Dans ce cas, les mesures de la distance d'écoulement pour ces cellules sont calculées uniquement jusqu’aux cellules de cuvettes dans lesquelles elles s’écoulent.

  • Lorsque l’outil est exécuté sans fournir de raster de direction de flux facultatif, la distance d’écoulement est évaluée en tenant compte de tous les chemins de flux de pente descendante possibles à partir de chaque cellule vers les cellules se trouvant dans le flux d’écoulement.

    Lorsque l’outil est exécuté avec un raster de direction de flux D8 facultatif, il n’existe qu’un seul chemin de flux de pente descendante possible à partir de chaque cellule vers une cellule d’écoulement et la distance d'écoulement est mesurée le long de ce chemin de flux unique.

  • Lorsque plusieurs chemins de flux se trouvent entre chaque cellule et les cellules du cours d’eau dans lequel elles s’écoulent, utilisez le paramètre Statistics Type (Type de statistique) pour calculer la distance d'écoulement minimale, moyenne pondérée ou maximale.

    Lorsqu’il n’existe qu’un seul chemin de flux depuis chaque cellule vers une cellule du flux, tous les types de statistiques produisent le même résultat.

  • Il est recommandé de créer le raster d’écoulement en entrée à l’aide du même raster de surface en entrée que celui qui est fourni en entrée dans l’outil. Vous pouvez créer des rasters d’écoulement à partir d’un raster de surface en entrée à l’aide des outils Direction de flux, Accumulation de flux et Con respectivement. Si vous souhaitez utiliser des écoulements provenant d’autres sources de données, pour optimiser les résultats, vous devez d’abord les inclure dans le raster de surface en entrée, puis exécuter l’outil Distance de flux dans le résultat.

  • Cet outil prend en charge le traitement parallèle. Il est possible d’obtenir de meilleures performances, en particulier sur les jeux de données volumineux, si votre ordinateur est doté de plusieurs processeurs ou de processeurs multicœurs. Pour plus d’informations concernant cette fonctionnalité et sa configuration, consultez la rubrique d’aide Traitement parallèle avec Spatial Analyst.

    Lorsque vous utilisez le traitement parallèle, des données temporaires sont écrites afin de gérer les blocs de données en cours de traitement. L’emplacement par défaut du dossier temporaire se trouve sur votre disque C:. Vous pouvez contrôler l’emplacement de ce répertoire en définissant une variable d’environnement système appelée TempFolders et en spécifiant le chemin d’accès du répertoire à utiliser (par exemple, E:\RasterCache). Si vous disposez de privilèges d’administration sur votre ordinateur, vous pouvez également utiliser une clé de registre (par exemple, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ ArcGISPro\Raster]).

    Par défaut, cet outil utilise 50 pourcent des cœurs disponibles. Si les données en entrée sont inférieures à 5 000 par 5 000 cellules en taille, le nombre de cœurs utilisé peut être moindre. Vous pouvez contrôler le nombre de cœurs que l’outil utilise à l’aide de l'environnement Facteur de traitement parallèle.

  • 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 d'écoulement en entrée

Raster d’écoulement en entrée représentant un réseau d'écoulement linéaire.

Raster Layer
Raster de surface en entrée

Raster en entrée qui représente une surface continue.

Raster Layer
Raster de direction de flux en entrée
(Facultatif)

Raster en entrée qui montre la direction du flux sortant de chaque cellule.

Lorsqu’un raster de direction de flux est fourni, les directions de pente descendante seront limitées à celles définies par les directions de flux en entrée.

Le raster de direction de flux peut être créé à l’aide de l’outil Direction de flux.

Le raster de direction de flux peut être créé à l’aide de la méthode D8, Multiple Flow Direction (MFD) ou D-Infinity. Utilisez le paramètre Input flow direction type (Type de direction de flux en entrée) pour spécifier la méthode utilisée lors de la création du raster de direction de flux.

Raster Layer
Type de distance
(Facultatif)

Détermine si le composant vertical ou horizontal de la distance d'écoulement est calculé.

  • VerticaleLes calculs de distance d’écoulement représentent le composant vertical de distance d’écoulement, le long du chemin de flux, à partir de chaque cellule du domaine vers les cellules se trouvant dans le flux d’écoulement. Il s’agit de l’option par défaut.
  • HorizontaleLes calculs de distance d’écoulement représentent le composant horizontal de distance d’écoulement, le long du chemin de flux, à partir de chaque cellule du domaine vers les cellules se trouvant dans le flux d’écoulement.
String
Type de direction de flux en entrée
(Facultatif)

Spécifie le type de raster de direction de flux en entrée.

  • D8Le type du raster de direction de flux en sortie est D8. Il s’agit de l’option par défaut.
  • MFDLe raster de direction de flux en entrée est de type MFD (Multiple Flow Direction).
  • DINFLe type du raster de direction de flux en entrée est D-Infinity (DINF).
String
Type de statistique
(Facultatif)

Détermine le type de statistique utilisé pour calculer la distance d’écoulement sur plusieurs chemins de flux. Lorsqu’il n’existe qu’un seul chemin de flux depuis chaque cellule vers une cellule du flux, tous les types de statistiques produisent le même résultat.

  • MinimalSi plusieurs chemins de flux existent, la distance d’écoulement minimale est calculée. Il s’agit de l’option par défaut.
  • Moyenne pondéréeSi plusieurs chemins de flux sont présents, une moyenne pondérée de la distance d’écoulement est calculée. La proportion de flux à partir d’une cellule vers ses cellules voisines en aval est utilisée comme pondération pour calculer la moyenne pondérée.
  • MaximumLorsque plusieurs chemins de flux sont présents, la distance d’écoulement maximale est calculée.
String

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Raster de distance d'écoulement en sortie.

Raster

FlowDistance(in_stream_raster, in_surface_raster, {in_flow_direction_raster}, {distance_type}, {flow_direction_type}, {statistics_type})
NomExplicationType de données
in_stream_raster

Raster d’écoulement en entrée représentant un réseau d'écoulement linéaire.

Raster Layer
in_surface_raster

Raster en entrée qui représente une surface continue.

Raster Layer
in_flow_direction_raster
(Facultatif)

Raster en entrée qui montre la direction du flux sortant de chaque cellule.

Lorsqu’un raster de direction de flux est fourni, les directions de pente descendante seront limitées à celles définies par les directions de flux en entrée.

Le raster de direction de flux peut être créé à l’aide de l’outil Direction de flux.

Le raster de direction de flux peut être créé à l’aide de la méthode D8, Multiple Flow Direction (MFD) ou D-Infinity. Utilisez le paramètre flow_direction_type pour spécifier la méthode utilisée lors de la création du raster de direction de flux.

Raster Layer
distance_type
(Facultatif)

Détermine si le composant vertical ou horizontal de la distance d'écoulement est calculé.

  • VERTICALLes calculs de distance d’écoulement représentent le composant vertical de distance d’écoulement, le long du chemin de flux, à partir de chaque cellule du domaine vers les cellules se trouvant dans le flux d’écoulement. Il s’agit de l’option par défaut.
  • HORIZONTALLes calculs de distance d’écoulement représentent le composant horizontal de distance d’écoulement, le long du chemin de flux, à partir de chaque cellule du domaine vers les cellules se trouvant dans le flux d’écoulement.
String
flow_direction_type
(Facultatif)

Spécifie le type de raster de direction de flux en entrée.

  • D8Le type du raster de direction de flux en sortie est D8. Il s’agit de l’option par défaut.
  • MFDLe raster de direction de flux en entrée est de type MFD (Multiple Flow Direction).
  • DINFLe type du raster de direction de flux en entrée est D-Infinity (DINF).
String
statistics_type
(Facultatif)

Détermine le type de statistique utilisé pour calculer la distance d’écoulement sur plusieurs chemins de flux. Lorsqu’il n’existe qu’un seul chemin de flux depuis chaque cellule vers une cellule du flux, tous les types de statistiques produisent le même résultat.

  • MINIMUMSi plusieurs chemins de flux existent, la distance d’écoulement minimale est calculée. Il s’agit de l’option par défaut.
  • WEIGHTED_MEANSi plusieurs chemins de flux sont présents, une moyenne pondérée de la distance d’écoulement est calculée. La proportion de flux à partir d’une cellule vers ses cellules voisines en aval est utilisée comme pondération pour calculer la moyenne pondérée.
  • MAXIMUMLorsque plusieurs chemins de flux sont présents, la distance d’écoulement maximale est calculée.
String

Valeur renvoyée

NomExplicationType de données
out_raster

Raster de distance d'écoulement en sortie.

Raster

Exemple de code

Exemple 1 d'utilisation de l’outil FlowDistance (fenêtre Python)

Cet exemple permet de créer un raster de distance d'écoulement.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFlowDistance = FlowDistance("streams", "elevation", "", "VERTICAL")
outFlowDistance.save("C:/sapyexamples/output/outflowdist01")
Exemple 2 d’utilisation de l'outil FlowDistance (script autonome)

Cet exemple permet de créer un raster de distance d'écoulement.

# Name: FlowDistance_Example.py
# Description: Creates a raster of horizontal flow distance from each cell to a cell 
# on the stream into which it drains.
# 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
inStreamRaster = "streams"
inSurfaceRaster = "elevation"
inFlowDirectionRaster = "flowdir"


# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute FlowDistance
outFlowDistance = FlowDistance(inStreamRaster, inSurfaceRaster, inFlowDirectionRaster, "HORIZONTAL")

# Save the output 
outFlowDistance.save("C:/sapyexamples/output/outflowdist02")

Informations de licence

  • Basic: Nécessite Spatial Analyst
  • Standard: Nécessite Spatial Analyst
  • Advanced: Nécessite Spatial Analyst

Rubriques connexes