Bassins versants (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Détermine la surface de captation au-dessus d’un ensemble de cellules dans un raster.

Pour en savoir plus sur l'utilisation de la fonction Bassins versants

Illustration

Illustration de l’outil 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é.

  • L’outil Bassins versants prend uniquement en charge un raster de direction de flux en entrée D8. Ce type de raster peut être créé à l’aide de l’outil Direction de flux, exécuté avec le type de direction de flux par défaut D8 (en Python, avec l’option D8).

  • Pour de meilleurs résultats, il convient d’utiliser au préalable l’outil Capture des points d'écoulement pour localiser les points d’écoulement vers les cellules présentant un flux cumulé élevé.

  • 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.

  • Cet outil prend en charge le traitement parallèle. Il est possible d’obtenir de meilleures performances, en particulier sur les jeux de données volumineux, si votre ordinateur est doté de plusieurs processeurs ou de processeurs multicœurs. Pour plus d’informations concernant cette fonctionnalité et sa configuration, consultez la rubrique d’aide Traitement parallèle avec Spatial Analyst.

    Lorsque vous utilisez le traitement parallèle, des données temporaires sont écrites afin de gérer les blocs de données en cours de traitement. L’emplacement par défaut du dossier temporaire se trouve sur votre disque C:. Vous pouvez contrôler l’emplacement de ce répertoire en définissant une variable d’environnement système appelée TempFolders et en spécifiant le chemin d’accès du répertoire à utiliser (par exemple, E:\RasterCache). Si vous disposez de privilèges d’administration sur votre ordinateur, vous pouvez également utiliser une clé de registre (par exemple, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ ArcGISPro\Raster]).

    Par défaut, cet outil utilise 50 pourcent des cœurs disponibles. Si les données en entrée sont inférieures à 5 000 par 5 000 cellules en taille, le nombre de cœurs utilisé peut être moindre. Vous pouvez contrôler le nombre de cœurs que l’outil utilise à l’aide de l'environnement Facteur de traitement parallèle.

  • 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.

Le raster de direction de flux peut être créé à l’aide de l’outil Direction de flux, exécuté avec le type de direction de flux D8 par défaut.

Raster Layer
Données de point d’écoulement d’entité ou de raster en entrée

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
Champ de point d’écoulement
(Facultatif)

Le 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 Value.

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

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie qui affiche la surface de captation.

Cette sortie est de type entier.

Raster

Watershed(in_flow_direction_raster, in_pour_point_data, {pour_point_field})
NomExplicationType 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, exécuté avec le type de direction de flux D8 par défaut.

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)

Le 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 Value.

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

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

# Execute Watershed
outWatershed = Watershed(inFlowDirection, inPourPointData, inPourPointField)

# Save the output 
outWatershed.save("C:/sapyexamples/output/outwtrshd02.tif")

Rubriques connexes