Bassins versants (Analyse raster)

Synthèse

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

Illustration

Illustration de l’outil Bassins versants

Utilisation

  • Cet outil de portail d’analyse raster est disponible lorsque vous êtes connecté à un portail ArcGIS Enterprise disposant d’un ArcGIS Image Server configuré pour Analyse raster. Lorsque cet outil est appelé, ArcGIS Pro est utilisé comme client et le traitement est effectué dans les serveurs fédérés avec ArcGIS Enterprise. Cet outil du portail prend en charge les couches de votre portail en entrée et crée la sortie dans le portail.

    La couche raster en entrée prend en charge les éléments suivants : couche du portail, URI ou URL d’un service d’imagerie ou sortie de l’outil Créer une couche de serveur d’imagerie. La couche d’entités en entrée peut être une couche du portail, ou une URI ou une URL d’un service d’entités. Cet outil ne prend pas en charge les données raster ou les couches locales. Bien que vous ayez la possibilité d’utiliser des données d’entité et des couches locales en entrée dans cet outil du portail, il est recommandé d’utiliser les couches de votre portail en entrée.

  • 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 classes 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. Les directions de flux D8 peuvent être créées à l’aide de l’outil Direction de flux, exécuté avec le type de direction de flux D8 par défaut.

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

Paramètres

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

Raster en entrée qui montre la direction du flux sortant de chaque cellule.

Raster Layer; Image Service; String
Raster ou entités de points d’écoulement en entrée

Emplacements des points d'écoulement en entrée.

Raster Layer; Feature Layer; Image Service; Feature Service; String
Nom en sortie

Nom du service raster de bassin versant en sortie.

Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom.

String
Champ de point d’écoulement
(Facultatif)

Champ utilisé pour attribuer des valeurs aux emplacements de points d'écoulement.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie.

Raster Layer

arcpy.ra.Watershed(inputFlowDirectionRaster, inPourPointRasterOrFeatures, outputName, {pourPointField})
NomExplicationType de données
inputFlowDirectionRaster

Raster en entrée qui montre la direction du flux sortant de chaque cellule.

Raster Layer; Image Service; String
inPourPointRasterOrFeatures

Emplacements des points d'écoulement en entrée.

Raster Layer; Feature Layer; Image Service; Feature Service; String
outputName

Nom du service raster de bassin versant en sortie.

Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom.

String
pourPointField
(Facultatif)

Champ utilisé pour attribuer des valeurs aux emplacements de points d'écoulement.

String

Sortie obtenue

NomExplicationType de données
outputRaster

Raster en sortie.

Raster Layer

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 de direction de flux.

import arcpy
arcpy.ra.Watershed("https://myserver/rest/services/flowdir/ImageServer","https://myserver/rest/services/streamlink/ImageServer","outWatershed1")
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 de direction de flux.

#---------------------------------------------------------------------------
# Name: Watershed_example02.py
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inFlowDirection = "https://myserver/rest/services/flowdir/ImageServer"
inPourPoint = "https://myserver/rest/services/streamlink/ImageServer"
outputWatershed = "outWatershed2"

# Execute Watershed raster analysis tool
arcpy.ra.Watershed(inFlowDirection, inPourPoint, outputWatershed)

Informations de licence

  • Basic: Nécessite ArcGIS Image Server
  • Standard: Nécessite ArcGIS Image Server
  • Advanced: Nécessite ArcGIS Image Server

Rubriques connexes