Disponible avec une licence Spatial Analyst.
Résumé
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. Si aucun champ n'est valide, le champ ObjectID (par exemple, OID ou FID) est utilisé par défaut.
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
Watershed (in_flow_direction_raster, in_pour_point_data, {pour_point_field})
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. Cette sortie est de type entier. | Raster |
Exemple de code
Premier exemple d'utilisation de l'outil Bassins versants (fenêtre Python)
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")
Deuxième exemple d'utilisation de l'outil Bassins versants (script autonome)
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")
Environnements
Informations de licence
- ArcGIS Desktop Basic: Requiert Spatial Analyst
- ArcGIS Desktop Standard: Requiert Spatial Analyst
- ArcGIS Desktop Advanced: Requiert Spatial Analyst