Disponible avec une licence Spatial Analyst.
Résumé
Permet de créer un raster délimitant tous les bassins de drainage.
Utilisation
Les bassins de drainage sont délimités dans la fenêtre d'analyse lorsque vous identifiez des lignes de crête entre des bassins. Le raster de direction de flux en entrée est analysé pour trouver tous les ensembles de cellules connexes rattachées au même bassin de drainage. Vous pouvez créer des bassins de drainage en identifiant les points d'écoulement situés aux contours de la fenêtre d'analyse (là où l'eau est susceptible de s'écouler du raster), de même que des cuvettes. Ensuite, vous devez désigner la surface de captation au-dessus de chaque point. Vous obtenez un raster de bassins de drainage.
Pour créer le raster de direction D8 en entrée, l’outil Direction de flux doit être exécuté avec le type de direction de flux par défaut D8.
Vous obtiendrez de meilleurs résultats si, lors de la création du raster Direction de flux D8 en entrée, l’option Force all edge cells to flow outward (Forcer l’écoulement vers l’extérieur sur les quatre bords) (FORCE dans Python) est activée.
Toutes les cellules dans le raster appartiendront à un bassin, même si ce bassin n'est qu'une seule cellule.
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.
Syntaxe
Basin (in_flow_direction_raster)
Paramètre | Explication | Type de données |
in_flow_direction_raster | Raster en entrée qui montre la direction du flux sortant de chaque cellule. Un raster de direction de flux peut être créé à l’aide de l’outil Direction de flux et du type de direction de flux D8 par défaut. | Raster Layer |
Valeur renvoyée
Nom | Explication | Type de données |
out_raster | Raster en sortie qui délimite les bassins de drainage. Cette sortie est de type entier. | Raster |
Exemple de code
Premier exemple (fenêtre Python)
Cet exemple décrit les bassins de drainage d'un raster Grid de direction de flux en entrée.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outBasin = Basin("flowdir")
outBasin.save("C:/sapyexamples/output/outbasin01")
Deuxième exemple (script autonome)
Cet exemple décrit les bassins de drainage d'un raster Grid de direction de flux en entrée.
# Name: Basin_Ex_02.py
# Description: Creates a raster delineating all drainage basins.
# 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
inFlowDirectionRaster = "flowdir"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute FlowDirection
outBasin = Basin(inFlowDirectionRaster)
# Save the output
outBasin.save("C:/sapyexamples/output/outbasin02")
Environnements
Informations de licence
- ArcGIS Desktop Basic: Requiert Spatial Analyst
- ArcGIS Desktop Standard: Requiert Spatial Analyst
- ArcGIS Desktop Advanced: Requiert Spatial Analyst