Accumulation d’écoulement (Outils Spatial Analyst)

Résumé

Crée un raster de flux cumulé dans chaque cellule. Un facteur de pondération peut être appliqué.

En savoir plus sur le fonctionnement de l’outil Accumulation de flux

Illustration

Utilisation

Lorsque vous utilisez l’outil Flow Accumulation (Accumulation de flux), vous obtenez un raster de flux cumulé vers chaque cellule, conformément à l’accumulation des pondérations de toutes ces cellules qui s’écoulent dans les cellules en pente descendante.
L’outil Flow Accumulation (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 Flow Direction (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 Flow Accumulation (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 Flow Accumulation (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 en entrée, 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 Flow Accumulation (Accumulation de flux) ne répond pas aux critères du paramètre d’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. La rubrique d’aide Traitement parallèle avec Spatial Analyst comporte des informations concernant cette fonctionnalité et sa configuration.

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 C: local. Vous pouvez contrôler l’emplacement de ce dossier en définissant une variable d’environnement système appelée TempFolders et en spécifiant le chemin d’accès au dossier à utiliser (par exemple, E:\\RasterCache). Si vous disposez de privilèges d’administrateur 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 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é 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.
Reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil.

Etiqueter	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. Le raster de direction de flux peut être créé à l’aide de l’outil Flow Direction (Direction de flux). Le raster de direction de flux peut être créé à l’aide de la méthode D8, Multiple Flow Direction (MFD) ou D-Infinity. Utilisez le paramètre 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.	Raster Layer
Raster de pondération en entrée (Facultatif)	Raster en entrée 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
Type de données en sortie (Facultatif)	Le raster d’accumulation en sortie peut être un entier, à virgule flottante ou de type double. Flottant—Le raster en sortie contient toujours des valeurs à virgule flottante. Il s’agit de l’option par défaut. Entier—Le raster en sortie sera un entier. Double—Le raster en sortie sera de type double.	String
Type de direction de flux en entrée (Facultatif)	Spécifie le type du raster de sens de circulation en entrée. D8—Le raster de sens de circulation en entrée est de type D8. Il s’agit de l’option par défaut. MFD—Le raster de sens de circulation en entrée est de type Multi Flow Direction (MFD). DINF—Le raster de sens de circulation en entrée est de type D-Infinity (DINF).	String

Valeur de retour

Etiqueter	Explication	Type de données
Raster d'accumulation en sortie	Raster en sortie qui montre le flux accumulé sur chaque cellule.	Raster

FlowAccumulation(in_flow_direction_raster, {in_weight_raster}, {data_type}, {flow_direction_type})

Nom	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 Flow Direction (Direction de flux). Le raster de direction de flux peut être créé à l’aide de la méthode D8, Multiple Flow Direction (MFD) ou 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 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. `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. `DOUBLE`—Le raster en sortie sera de type double.	String
flow_direction_type (Facultatif)	Spécifie le type du raster de sens de circulation en entrée. `D8`—Le raster de sens de circulation en entrée est de type D8. Il s’agit de l’option par défaut. `MFD`—Le raster de sens de circulation en entrée est de type Multi Flow Direction (MFD). `DINF`—Le raster de sens de circulation en entrée est de type D-Infinity (DINF).	String

Valeur de retour

Nom	Explication	Type de données
out_accumulation_raster	Raster en sortie qui montre le flux accumulé sur chaque cellule.	Raster

Exemple de code

FlowAccumulation Exemple 1 (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")

FlowAccumulation Exemple 2 (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"

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

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

Environnements

Validation automatique, Taille de cellule, Cell Size Projection Method (Méthode de projection de la taille de cellule), Compression, Espace de travail courant, Etendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Facteur de traitement parallèle, Pyramide, Espace de travail temporaire, Raster de capture, Taille de tuile

Informations de licence

Basic: Nécessite Spatial Analyst
Standard: Nécessite Spatial Analyst
Advanced: Nécessite Spatial Analyst

Accumulation d’écoulement (Outils Spatial Analyst)

Résumé

Illustration

Utilisation

Paramètres

Valeur de retour

Environnements

Informations de licence

Rubriques connexes