Accumulation de flux (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Résumé

Crée un raster de flux cumulé dans chaque cellule. Le cas échéant, vous pouvez utiliser un facteur de pondération.

Pour en savoir plus sur le fonctionnement de l'outil Accumulation de flux

Illustration

Illustration de l’outil Accumulation de flux D8
Flow_Acc = FlowAccumulation(Flow_Dir)

Utilisation

  • Lorsque vous utilisez l'outil Accumulation de flux, vous obtenez un raster de flux cumulé relatif à chaque cellule, conformément à l'accumulation des pondérations de toutes ces cellules qui s'écoulent dans les cellules en pente descendante.

  • L’outil Accumulation de flux prend en charge trois algorithmes de modélisation lors du calcul du flux cumulé. Il s’agit des méthodes de flux D8, MFD (Multiple Flow Direction) et DINF (D-Infinity).

  • Si le raster de direction de flux en entrée n'est pas créé avec l'outil Direction de flux, il est probable que vous obtiendrez un écoulement de flux en boucle. Si la direction de flux contient une boucle, l’outil Accumulation de flux effectue indéfiniment les mêmes opérations sans s’arrêter.

    La direction de flux en entrée peut être créée à l’aide des méthodes D8, MFD (Multiple Flow Direction) ou DINF (D-Infinity). Le type de raster de direction de flux en entrée entre ces trois méthodes a une influence sur la manière dont l’outil Accumulation de flux divise et accumule le flux dans chaque cellule. Utilisez Input flow direction type (Type de direction de flux en entrée) pour spécifier la méthode utilisée lors de la création du raster de direction de flux.

  • Les cellules dont la direction n'est pas définie sont en réception ; il n'existe pas d'écoulement vers le bas.

    Pour un raster de direction de flux D8, une cellule est réputée être associée à une direction indéterminée lorsque sa valeur dans le raster de direction est différente de 1, 2, 4, 8, 16, 32, 64 ou 128.

    Pour un raster de direction de flux D-Infinity, une cellule est réputée être associée à une direction indéterminée lorsque sa valeur dans le raster de direction est égale à -1.

  • Le flux cumulé repose sur le nombre du total ou d’une fraction des cellules qui s'écoulent dans chaque cellule dans le raster en sortie. La cellule de traitement sélectionnée n'est pas prise en compte dans cette accumulation.

  • Les cellules en sortie présentant une accumulation de flux élevée sont des zones de flux concentré qui peuvent être utilisées pour identifier des canaux d'écoulement.

  • Les cellules en sortie présentant une accumulation de flux nulle sont des zones topographiques locales élevées qui peuvent être utilisées pour identifier des crêtes.

  • L'outil Accumulation de flux ne répond pas aux critères de l'environnement Compression. Le raster en sortie sera toujours décompressé.

  • 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, les données temporaires sont écrites pour gérer les blocs de données en cours de traitement. L’emplacement par défaut du dossier temporaire se trouve sur votre disque local 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 administrateur sur votre ordinateur, vous pouvez également utiliser une clé du Registre (par exemple, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).

    Par défaut, cet outil utilise 50 pour cent 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és 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.

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

Syntaxe

FlowAccumulation(in_flow_direction_raster, {in_weight_raster}, {data_type}, {flow_direction_type})
ParamètreExplicationType 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.

Le raster de direction de flux peut être créé à l’aide des méthodes D8, MFD (Multiple Flow Direction) et D-Infinity. Utilisez le paramètre flow_direction_type pour spécifier la méthode utilisée lors de la création du raster de direction de flux.

Raster Layer
in_weight_raster
(Facultatif)

Raster en entrée facultatif pour appliquer une pondération à chaque cellule.

Si aucun raster de pondération n'est spécifié, une pondération par défaut de 1 est appliquée à chaque cellule. Pour chaque cellule du raster en sortie, le résultat est le nombre de cellules arrivant dans la cellule.

Raster Layer
data_type
(Facultatif)

Le raster d’accumulation en sortie peut être un entier, à virgule flottante ou de type double.

  • FLOATLe raster en sortie contient toujours des valeurs à virgule flottante. Il s’agit de l’option par défaut.
  • INTEGERLe raster en sortie sera un entier.
  • DOUBLELe raster en sortie sera de type double.
String
flow_direction_type
(Facultatif)

Le raster de direction de flux en entrée peut être de type D8, MFD (Multiple Flow Direction) ou DINF (D-Infinity).

  • D8Le type du raster de direction de flux en sortie est D8. Il s’agit de l’option par défaut.
  • MFDLe raster de direction de flux en entrée est de type MFD (Multiple Flow Direction).
  • DINFLe type du raster de direction de flux en entrée est D-Infinity (DINF).
String

Valeur renvoyée

NomExplicationType de données
out_accumulation_raster

Raster en sortie qui montre le flux accumulé sur chaque cellule.

Raster

Exemple de code

Premier exemple d'utilisation de l'outil FlowAccumulation (fenêtre Python)

Dans cet exemple, on crée un raster de flux cumulé dans chaque cellule d'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"
outFlowAccumulation = FlowAccumulation("flowdir")
outFlowAccumulation.save("C:/sapyexamples/output/outflowacc01")
Deuxième exemple d'utilisation de l'outil FlowAccumulation (script autonome)

Dans cet exemple, on crée un raster de flux cumulé dans chaque cellule d'un raster IMG de direction de flux en entrée.

# Name: FlowAccumulation_Ex_02.py
# Description: Creates a raster of accumulated flow to each cell.
# 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
inFlowDirRaster = "flowdir"
inWeightRaster = ""
dataType = "INTEGER"

# Execute FlowDirection
outFlowAccumulation = FlowAccumulation(inFlowDirRaster, inWeightRaster, dataType)

# Save the output 
outFlowAccumulation.save("C:/sapyexamples/output/outflowacc02.img")

Informations de licence

  • Basic: Requiert Spatial Analyst
  • Standard: Requiert Spatial Analyst
  • Advanced: Requiert Spatial Analyst

Rubriques connexes