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 via l’identification des lignes de crête entre les bassins. Le raster de direction de flux en entrée est analysé pour trouver tous les ensembles de cellules connectées qui sont rattachés au même bassin de drainage. Les bassins de drainage sont créés en localisant les points d’écoulement situés aux extrémités de la fenêtre d’analyse (là où l’eau est susceptible de s’écouler hors du raster), de même que les cuvettes, puis en identifiant la surface de captation au-dessus de chaque point d’écoulement. Un raster de bassins de drainage est alors obtenu.

  • Pour créer le raster de direction de flux 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, au moment de créer le raster Direction de flux D8 en entrée, l’option Forcer l’écoulement vers l’extérieur sur les quatre bords (FORCE en Python) est activée.

  • Toutes les cellules du raster appartiendront à un bassin, même si ce bassin n’est composé que d’une seule cellule.

  • Lorsque le format raster en sortie est .crf, cet outil prend en charge l’environnement de stockage raster Pyramide. Des pyramides seront créées dans la sortie par défaut. Pour tout autre format en sortie, cet environnement n’est pas pris en charge et aucune pyramide n’est créée.

  • 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éé avec l’outil Direction de flux, en utilisant le type de direction de flux par défaut D8.

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éé avec l’outil Direction de flux, en utilisant le type de direction de flux par défaut D8.

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

Exemple 1 d’utilisation de la fonction Basin (fenêtre Python)

Cet exemple identifie 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")
Exemple 2 d’utilisation de la fonction Basin (script autonome)

Cet exemple identifie 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