Bassin (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

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.

Paramètres

ÉtiquetteExplicationType de données
Raster de direction de flux D8 en entrée

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

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie qui délimite les bassins de drainage.

Cette sortie est de type entier.

Raster

Basin(in_flow_direction_raster)
NomExplicationType 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

NomExplicationType 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"

# Execute FlowDirection
outBasin = Basin(inFlowDirectionRaster)

# Save the output 
outBasin.save("C:/sapyexamples/output/outbasin02")

Informations de licence

  • Basic: Nécessite Spatial Analyst
  • Standard: Nécessite Spatial Analyst
  • Advanced: Nécessite Spatial Analyst

Rubriques connexes