Disponible avec une licence Spatial Analyst.
Récapitulatif
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.
Vous pouvez optimiser les résultats si vous créez un raster de direction de flux en entrée et que vous sélectionnez l'option Forcer l'écoulement vers l'extérieur sur les quatre bords (FORCE dans Python).
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. Le raster de direction de flux peut être créé à l'aide de l'outil Direction de flux. | 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 for Desktop Basic: Requis ArcGIS Spatial Analyst
- ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst
- ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst