Disponible avec une licence Spatial Analyst.
Résumé
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 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).
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.
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., R. L. Bras, I. Rodriguez–Iturbe. 1991. On the Extraction of Channel Networks from Digital Elevation Data. Hydrological Processes. 5: 81–100.
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, 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.
| 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"
# 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
Informations de licence
- ArcGIS Desktop Basic: Requiert Spatial Analyst
- ArcGIS Desktop Standard: Requiert Spatial Analyst
- ArcGIS Desktop Advanced: Requiert Spatial Analyst