Ordre d'écoulement (Spatial Analyst)

Récapitulatif

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 rastérisé, 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 où 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).

Syntaxe

StreamOrder (in_stream_raster, in_flow_direction_raster, {order_method})

Paramètre	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é en tant que 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.	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 flux de 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. Toutes les liaisons 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. Il sera 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"

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

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

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

Environnements

Taille de cellule, Espace de travail courant, Système de coordonnées en sortie, Etendue, Espace de travail temporaire, Raster de capture

Informations de licence

ArcView : Obligatoire Spatial Analyst

ArcEditor : Obligatoire Spatial Analyst

ArcInfo : Obligatoire Spatial Analyst