Bassins versants (Spatial Analyst)
Récapitulatif
Détermine la surface de captation au-dessus d’un ensemble de cellules d’un raster.
Pour en savoir plus sur l'utilisation de la fonction Bassins versants
Utilisation
-
La valeur de chaque bassin versant est extraite de la valeur de la source dans les données raster ou vecteur de points d'écoulement. Lorsque le point d'écoulement est un jeu de données raster, les valeurs de cellule sont utilisées. Lorsque le point d'écoulement est un jeu de données d'entité ponctuelles, les valeurs proviennent du champ spécifié.
-
Pour obtenir de meilleurs résultats, il convient d'utiliser l'outil Capture des points d'écoulement au préalable afin de localiser les points d'écoulement aux cellules présentant une accumulation de flux élevée.
Lorsque vous spécifiez les emplacements des points d'écoulement en entrée comme données d'entité, le champ par défaut est le premier champ valide disponible. S'il n'existe aucun champ valide, le champ ObjectID (par exemple, OID ou FID) est utilisé par défaut.
Syntaxe
| 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 |
in_pour_point_data |
Emplacements des points d'écoulement en entrée. Pour un raster, il s'agit des cellules au-dessus desquelles la surface de captation est déterminée. Toutes les cellules n'ayant pas la valeur NoData sont utilisées en tant que cellules sources. Pour un jeu de données d'entité ponctuelle, il s'agit des emplacements au-dessus desquels la surface de captation est déterminée. | Raster Layer | Feature Layer |
pour_point_field (Facultatif) |
Champ utilisé pour attribuer des valeurs aux emplacements de points d'écoulement. Si le jeu de données des points d'écoulement est un raster, utilisez la valeur. Si le jeu de données des points d'écoulement est une entité, utilisez un champ numérique. Si le champ contient des valeurs à virgule flottante, celles-ci sont remplacées par des entiers. | Field |
Valeur renvoyée
| Nom | Explication | Type de données |
| out_raster |
Raster en sortie qui affiche la surface de captation. Il sera de type entier. | Raster |
Exemple de code
Cet exemple détermine la surface de captation pour les emplacements de point d'écoulement sélectionnés sur un raster GRID de sens de circulation.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outWatershed = Watershed("flowdir", "pourpoint")
outWatershed.save("C:/sapyexamples/output/outwtrshd01")
Cet exemple détermine la surface de captation pour les emplacements de point d'écoulement sélectionnés sur un raster GRID de sens de circulation et génère le bassin versant sous la forme d'un raster TIFF.
# Name: Watershed_Ex_02.py
# Description: Determines the contributing area above a set of cells in a
# raster.
# 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
inFlowDirection = "flowdir"
inPourPointData = "pourpoint"
inPourPointField = "VALUE"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Watershed
outWatershed = Watershed(inFlowDirection, inPourPointData, inPourPointField)
# Save the output
outWatershed.save("C:/sapyexamples/output/outwtrshd02.tif")