Ordre d'écoulement (Spatial Analyst)

Niveau de licence :BasicStandardAdvanced

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

Syntaxe

StreamOrder (in_stream_raster, in_flow_direction_raster, {order_method})
ParamètreExplicationType 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

NomExplicationType 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

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Requis ArcGIS Spatial Analyst
ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst
ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst
5/10/2014