Longueur de flux (Analyse raster)

Synthèse

Calcule, pour chaque cellule, le composant horizontal ou vertical de la distance de la pente descendante, selon les chemins de circulation, vers les cellules d'un cours d’eau dans lequel elle s'écoule. Dans le cas de plusieurs chemins de circulation, la distance d’écoulement minimale, moyenne pondérée ou maximale peut être calculée.

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

Illustration

Utilisation

• Cet outil de portail d'analyse raster est disponible si vous êtes connecté à un portail ArcGIS Enterprise où ArcGIS Image Server est configuré pour l'Analyse raster. Si cet outil est exécuté, ArcGIS Pro est utilisé comme client et le traitement est effectué sur les serveurs fédérés avec ArcGIS Enterprise. L'outil de portail accepte les couches de votre portail en entrée et crée la sortie dans votre portail.

  La couche raster en entrée prend en charge une couche du portail, un URI ou une URL vers un service d'imagerie, ou la sortie de l'outil Make Image Server Layer (Créer une couche de serveur d’imagerie). Cet outil ne prend pas en charge les couches ou données raster locales.

• Pour limiter les directions de pente descendante le long desquelles la distance d’écoulement est mesurée, fournissez un raster de direction de flux 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 Longueur de flux.

  Si ce raster de surface en entrée ne comporte aucune cuvette, les mesures de distance s’étendent aux cellules de cours d’eau représentées par le raster des cours d’eau 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 cours d’eau. Dans ce cas, les mesures de la longueur de flux pour ces cellules sont calculées uniquement jusqu’aux cellules de cuvettes dans lesquelles elles s’écoulent.

• Lorsque l’outil est exécuté sans 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 de cours d’eau dans lesquelles ils se déversent.

  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 de cours d’eau et la distance d’écoulement est mesurée le long de ce chemin d’écoulement unique.

• 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. Si vous disposez d’une licence d’extension Spatial Analyst, vous pouvez créer des rasters d’écoulement à partir d’un raster de surface en entrée avec les outils Direction de flux, Accumulation de flux et Con, respectivement. Si vous voulez utiliser les cours d’eau provenant d’autres sources de données, vous devez, pour obtenir de meilleurs résultats, les incruster sur le raster de surface en entrée et exécuter l’outil Distance d’écoulement.

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

  Si un seul chemin de flux est présent entre chaque cellule et une cellule du cours d’eau, tous les types de statistiques produisent le même résultat.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster d’écoulement en entrée	Raster en entrée qui définit le réseau hydrographique.	Raster Layer; Image Service; String
Raster de surface en entrée	Raster en entrée qui représente une surface continue.	Raster Layer; Image Service; String
Nom en sortie	Le nom du service raster de distance d’écoulement en sortie. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom.	String
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 sens de circulation peut être créé à l’aide de la méthode D8, MFD ou DINF. Utilisez le paramètre Flow Direction Type (Type de sens de circulation) pour spécifier la méthode utilisée lors de la création du raster de sens de circulation.	Raster Layer; Image Service; String
Type de distance (Facultatif)	Type de distance à calculer. Vertical—Les calculs de la longueur de flux représentent le composant vertical de la longueur de flux minimale, le long du chemin de flux, à partir de chaque cellule du domaine vers les cellules de l’écoulement dans lesquelles elles transitent. Il s’agit de l’option par défaut. Horizontal—Les calculs de la longueur de flux représentent le composant horizontal de la longueur de flux minimale, le long du chemin de flux, à partir de chaque cellule du domaine vers les cellules de l’écoulement dans lesquelles elles transitent.	String
Type de direction de flux (Facultatif)	Spécifie le type du raster de sens de circulation en entrée. D8—Le raster de sens de circulation en entrée est de type D8. Il s’agit de l’option par défaut. MFD—Le raster de sens de circulation en entrée est de type Multi Flow Direction (MFD). DINF—Le raster de sens de circulation en entrée est de type 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. Si un seul chemin de flux est présent entre chaque cellule et une cellule du cours d’eau, tous les types de statistiques produisent le même résultat. Minimum—Si plusieurs chemins de flux sont présents, la distance d’écoulement minimale est calculée. Il s’agit de l’option par défaut. Moyenne pondérée—Si plusieurs chemins de flux sont présents, une moyenne pondérée de la distance d’écoulement est calculée. La proportion de flux d’une cellule par rapport à ses cellules voisines en aval est utilisée comme poids pour calculer la moyenne pondérée. Maximum—Lorsque plusieurs chemins de flux sont présents, la distance d’écoulement maximale est calculée.	String

Sortie obtenue

Étiquette	Explication	Type de données
Raster en sortie	Raster en sortie.	Raster Layer

Python

arcpy.ra.FlowDistance(inputStreamRaster, inputSurfaceRaster, outputName, {inputFlowDirectionRaster}, {distanceType}, {flowDirectionType}, {statisticsType})

Nom	Explication	Type de données
inputStreamRaster	Raster en entrée qui définit le réseau hydrographique.	Raster Layer; Image Service; String
inputSurfaceRaster	Raster en entrée qui représente une surface continue.	Raster Layer; Image Service; String
outputName	Le nom du service raster de distance d’écoulement en sortie. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom.	String
inputFlowDirectionRaster (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 sens de circulation peut être créé à l’aide de la méthode D8, MFD ou DINF. Utilisez le paramètre flowDirectionType pour spécifier la méthode utilisée lors de la création du raster de sens de circulation.	Raster Layer; Image Service; String
distanceType (Facultatif)	Type de distance à calculer. VERTICAL—Les calculs de la longueur de flux représentent le composant vertical de la longueur de flux minimale, le long du chemin de flux, à partir de chaque cellule du domaine vers les cellules de l’écoulement dans lesquelles elles transitent. Il s’agit de l’option par défaut. HORIZONTAL—Les calculs de la longueur de flux représentent le composant horizontal de la longueur de flux minimale, le long du chemin de flux, à partir de chaque cellule du domaine vers les cellules de l’écoulement dans lesquelles elles transitent.	String
flowDirectionType (Facultatif)	Spécifie le type du raster de sens de circulation en entrée. D8—Le raster de sens de circulation en entrée est de type D8. Il s’agit de l’option par défaut. MFD—Le raster de sens de circulation en entrée est de type Multi Flow Direction (MFD). DINF—Le raster de sens de circulation en entrée est de type D-Infinity (DINF).	String
statisticsType (Facultatif)	Détermine le type de statistique utilisé pour calculer la distance d’écoulement sur plusieurs chemins de flux. Si un seul chemin de flux est présent entre chaque cellule et une cellule du cours d’eau, tous les types de statistiques produisent le même résultat. MINIMUM—Si plusieurs chemins de flux sont présents, la distance d’écoulement minimale est calculée. Il s’agit de l’option par défaut. WEIGHTED_MEAN—Si plusieurs chemins de flux sont présents, une moyenne pondérée de la distance d’écoulement est calculée. La proportion de flux d’une cellule par rapport à ses cellules voisines en aval est utilisée comme poids pour calculer la moyenne pondérée. MAXIMUM—Lorsque plusieurs chemins de flux sont présents, la distance d’écoulement maximale est calculée.	String

Sortie obtenue

Nom	Explication	Type de données
outputRaster	Raster en sortie.	Raster Layer

Exemple de code

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

Dans cet exemple, on calcule la distance de flux horizontale de pente descendante minimum jusqu’à une cellule sur le raster d’écoulement.

import arcpy
arcpy.ra.FlowDistance("https://myserver/rest/services/streams/ImageServer","https://myserver/rest/services/elevation_fill/ImageServer","outFlowDistanceVertical1")

Exemple 2 d’utilisation de l'outil FlowDistance (script autonome)

Dans cet exemple, on calcule la distance de flux verticale de pente descendante minimum jusqu’à une cellule sur le raster d’écoulement.

#---------------------------------------------------------------------------
# Name: FlowDistance_example02.py
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inStreams = "https://myserver/rest/services/streams/ImageServer"
inSurface = "https://myserver/rest/services/elevation_fill/ImageServer"
outputFlowDistance = "outFlowDistanceVertical2"
inFlowDirection = ""
distanceType = "VERTICAL"

# Execute Flow Distance raster analysis tool
arcpy.ra.FlowDistance(inStreams, inSurface, outputFlowDistance, inFlowDirection, distanceType)

Environnements

Taille de cellule, Étendue, Masque, Système de coordonnées en sortie, Pyramide, Raster de capture

Informations de licence

• Basic: Nécessite ArcGIS Image Server
• Standard: Nécessite ArcGIS Image Server
• Advanced: Nécessite ArcGIS Image Server