Ordre d’écoulement (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Attribue un ordre numérique aux segments d'un raster représentant les branches d'un réseau linéaire.

Pour en savoir plus sur l'utilisation de la fonction Ordre d'écoulement

Utilisation

• La sortie de l'outil Ordre d'écoulement sera de meilleure qualité si le raster d'écoulement en entrée et le raster de direction de flux en entrée sont dérivés de la même surface. Si le raster d'écoulement est dérivé d'un jeu de données de flux rasterisé, la sortie peut ne pas être utilisable du fait que, cellule par cellule, la direction ne correspondra pas à l'emplacement des cellules de flux.

• Les résultats obtenus avec l'outil Accumulation de flux peuvent être utilisés pour créer un raster de réseau hydrographique en fixant un seuil pour sélectionner les cellules avec une accumulation de flux élevée. Par exemple, les cellules dans lesquelles plus de 100 cellules s'écoulent sont utilisées pour définir le réseau hydrographique. Utilisez l’outil Con ou SetNull pour créer un raster de réseau hydrographique dans lequel des valeurs d’accumulation de flux de 100 ou plus passent à 1, et le reste est mis à l’arrière-plan (NoData). Le réseau hydrographique obtenu peut être utilisé dans l'outil Liaison d'écoulement et Ecoulement vers entité.

  Une méthode analytique pour identifier un seuil approprié et définir un réseau hydrographique est présentée dans l'ouvrage de Tarboton (1991).

• L’outil Ordre d’écoulement prend uniquement en charge un raster de direction de flux en entrée D8. Les directions de flux D8 peuvent être créées à l’aide de l’outil Direction de flux, exécuté avec le type de direction de flux D8 par défaut.

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

• Bibliographie :

  Tarboton D. G., Bras, R. L., Rodriguez–Iturbe, I. 1991. On the Extraction of Channel Networks from Digital Elevation Data. Hydrological Processes. 46(5): 81-100.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster d’écoulement en entrée	Raster en entrée représentant un réseau d'écoulement linéaire. Le réseau linéaire raster d’écoulement en entrée doit être représenté sous forme de valeurs supérieures ou égales à un sur un arrière-plan de valeurs NoData.	Raster Layer
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, exécuté avec le type de direction de flux D8 par défaut.	Raster Layer
Méthode de hiérarchisation d'écoulement (Facultatif)	Méthode utilisée pour attribuer l'ordre d'écoulement. Strahler—Méthode de hiérarchisation d'écoulement proposée par Strahler en 1952. L'ordre d'écoulement augmente uniquement lorsque des cours d'eau du même ordre se croisent. Ainsi, l'intersection d'une liaison de premier ordre et d'une liaison de deuxième ordre reste une liaison de deuxième ordre, mais ne crée pas une liaison de troisième ordre. Il s’agit de l’option par défaut. Shreve—Méthode de hiérarchisation d'écoulement par magnitude, proposée par Shreve en 1967. Tous les liens sans affluent ont une magnitude (ordre) de un. Les magnitudes sont des pentes descendantes additives. Lorsque deux liaisons se croisent, leurs magnitudes s'ajoutent et le résultat est attribué au lien de pente descendante.	String

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Raster d'ordre d'écoulement en sortie. Cette sortie est de type entier.	Raster

Python

StreamOrder(in_stream_raster, in_flow_direction_raster, {order_method})

Nom	Explication	Type de données
in_stream_raster	Raster en entrée représentant un réseau d'écoulement linéaire. Le réseau linéaire raster d’écoulement en entrée doit être représenté sous forme de valeurs supérieures ou égales à un sur un arrière-plan de valeurs NoData.	Raster Layer
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, exécuté avec le type de direction de flux D8 par défaut.	Raster Layer
order_method (Facultatif)	Méthode utilisée pour attribuer l'ordre d'écoulement. STRAHLER—Méthode de hiérarchisation d'écoulement proposée par Strahler en 1952. L'ordre d'écoulement augmente uniquement lorsque des cours d'eau du même ordre se croisent. Ainsi, l'intersection d'une liaison de premier ordre et d'une liaison de deuxième ordre reste une liaison de deuxième ordre, mais ne crée pas une liaison de troisième ordre. Il s’agit de l’option par défaut. SHREVE—Méthode de hiérarchisation d'écoulement par magnitude, proposée par Shreve en 1967. Tous les liens sans affluent ont une magnitude (ordre) de un. Les magnitudes sont des pentes descendantes additives. Lorsque deux liaisons se croisent, leurs magnitudes s'ajoutent et le résultat est attribué au lien de pente descendante.	String

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Raster d'ordre d'écoulement en sortie. Cette sortie est de type entier.	Raster

Exemple de code

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

Cet exemple attribue un ordre numérique aux segments d'un raster représentant les branches d'un réseau linéaire.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outStreamOrder = StreamOrder("stream", "flowdir", "STRAHLER")
outStreamOrder.save("c:/sapyexamples/output/outstrmordr01")

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

Cet exemple attribue un ordre numérique aux segments d'un raster représentant les branches d'un réseau linéaire.

# Name: StreamOrder_Ex_02.py
# Description: Assigns a numeric order to segments of a raster 
#              representing branches of a linear network.
# 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
inStreamRast = "stream"
inFlowDirectionRaster = "flowdir"
orderMethod = "STRAHLER"

# Execute StreamOrder
outStreamOrder = StreamOrder(inStreamRast, inFlowDirectionRaster, orderMethod)

# Save the output 
outStreamOrder.save("c:/sapyexamples/output/outstrmordr02")

Environnements

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