Bassins versants (Analyse raster)

Synthèse

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

Illustration

Utilisation

• Cet outil de portail d'analyse raster est disponible si vous êtes connecté à un portail ArcGIS Enterprise où ArcGIS 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

Boîte de dialogue

Étiquette	Explication	Type 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

Étiquette	Explication	Type de données
Raster en sortie	Raster en sortie.	Raster Layer

Python

arcpy.ra.Watershed(inputFlowDirectionRaster, inPourPointRasterOrFeatures, outputName, {pourPointField})

Nom	Explication	Type 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

Nom	Explication	Type 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)

Environnements

Étendue, Taille de cellule, Masque, Système de coordonnées en sortie, Pyramide, Raster de capture

Informations de licence

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