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 si vous êtes connecté à un portail ArcGIS EnterpriseArcGIS Image Server est configuré pour l'Analyse raster. Si cet outil est exécuté, ArcGIS Pro est utilisé comme client et le traitement est effectué sur les serveurs fédérés avec ArcGIS Enterprise. L'outil de portail accepte les couches de votre portail en entrée et crée la sortie dans votre portail.

    La couche raster en entrée prend en charge une couche du portail, un URI ou une URL vers un service d'imagerie, ou la sortie de l'outil Make Image Server Layer (Créer une couche de serveur d’imagerie). La couche d'entités en entrée peut correspondre à une couche du portail, un URI ou une URL vers un service d'entités. Cet outil ne prend pas en charge les couches ou données raster locales. Vous pouvez utiliser des couches et données d'entités locales en entrée dans cet outil de portail, mais 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