Accumulation de flux—Aide

Disponible avec une licence Spatial Analyst.

Résumé
Illustration
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

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

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.
Les cellules dont la direction n'est pas définie sont en réception ; il n'existe pas d'écoulement vers le bas. 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.
Le flux cumulé repose sur le nombre de 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.
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 vous obtenez une direction de flux en boucle, l'outil Accumulation de flux effectue indéfiniment les mêmes opérations sans s'arrêter.
L'outil Accumulation de flux ne répond pas aux critères de l'environnement Compression. Le raster en sortie sera toujours décompressé.
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})

Paramètre	Explication	Type 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.	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 ou à virgule flottante. FLOAT — Le raster en sortie contient toujours des valeurs à virgule flottante. Il s'agit de l'option par défaut. INTEGER — Le raster en sortie sera un entier.	String

Valeur renvoyée

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

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

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

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

ArcMap

Accumulation de flux