Cuvettes (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Crée un raster identifiant toutes les cuvettes ou zones de drainage interne.

En savoir plus sur le fonctionnement de l’outil Cuvettes

Utilisation

  • Une cuvette est une cellule ou un ensemble de cellules limitrophes dont la direction de flux ne peut pas se voir attribuer l'une des huit valeurs valides dans un raster de direction de flux. Cela peut survenir lorsque toutes les cellules voisines sont plus élevées que la cellule de traitement ou lorsque deux cellules s'écoulent en boucle l’une dans l’autre.

  • L’outil Cuvette prend uniquement en charge un raster de direction de flux D8 en entrée. 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.

  • La sortie de l’outil Cuvettes est un raster de type entier dans lequel chaque cuvette se voit attribuer une valeur unique. Les cuvettes sont numérotées de 1 jusqu’au nombre de cuvettes.

  • 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

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie qui affiche toutes les cuvettes (zones de drainage interne) sur la surface en entrée.

Cette sortie est de type entier.

Raster

Sink(in_flow_direction_raster)
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

Valeur renvoyée

NomExplicationType de données
out_raster

Raster en sortie qui affiche toutes les cuvettes (zones de drainage interne) sur la surface en entrée.

Cette sortie est de type entier.

Raster

Exemple de code

Exemple 1 d’utilisation de la fonction Sink (fenêtre Python)

Cet exemple identifie les cuvettes dans un raster Grid de direction de flux en entrée.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outSink = Sink("flowdir")
outSink.save("C:/sapyexamples/output/outsink01")
Exemple 2 d’utilisation de la fonction Sink (script autonome)

Cet exemple identifie les cuvettes dans un raster Grid de direction de flux en entrée.

# Name: Sink_Ex_02.py
# Description: Creates a raster identifying all sinks or areas of internal drainage.
# 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
inFlowDirectionRaster = "flowdir"

# Execute FlowDirection
outSink = Sink(inFlowDirectionRaster)

# Save the output 
outSink.save("C:/sapyexamples/output/outsink02")

Rubriques connexes