Accumulation de flux (Analyse raster)

Synthèse

Crée un raster de flux cumulé dans chaque cellule.

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). Cet outil ne prend pas en charge les couches ou données raster locales.

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

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

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. Le raster de sens de circulation peut être créé à l’aide de la méthode D8, MFD ou DINF. Utilisez le paramètre Flow Direction Type (Type de sens de circulation) pour spécifier la méthode utilisée lors de la création du raster de sens de circulation.	Raster Layer; Image Service; String
Nom en sortie	Nom du service raster d’accumulation de flux 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
Raster de pondération en entrée (Facultatif)	Raster en entrée entier facultatif pour appliquer une pondération à chaque cellule.	Raster Layer; Image Service; String
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 (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

Sortie obtenue

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

Python

arcpy.ra.FlowAccumulation(inputFlowDirectionRaster, outputName, {inputWeightRaster}, {dataType}, {flowDirectionType})

Nom	Explication	Type de données
inputFlowDirectionRaster	Raster en entrée qui montre la direction du flux sortant de chaque cellule. Le raster de sens de circulation peut être créé à l’aide de la méthode D8, MFD ou DINF. Utilisez le paramètre flowDirectionType pour spécifier la méthode utilisée lors de la création du raster de sens de circulation.	Raster Layer; Image Service; String
outputName	Nom du service raster d’accumulation de flux 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
inputWeightRaster (Facultatif)	Raster en entrée entier facultatif pour appliquer une pondération à chaque cellule.	Raster Layer; Image Service; String
dataType (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
flowDirectionType (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

Sortie obtenue

Nom	Explication	Type de données
outputRaster	Raster en sortie.	Raster Layer

Exemple de code

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

Cet exemple permet de créer un raster de flux cumulé dans chaque cellule d'un raster de direction de flux en entrée.

import arcpy
arcpy.ra.FlowAccumulation("https://myserver/rest/services/flowdir/ImageServer","outFlowAccumulation1")

Deuxième exemple d'utilisation de l'outil FlowAccumulation (script autonome)

Cet exemple permet de créer un raster de flux cumulé dans chaque cellule d'un raster de direction de flux en entrée.

#---------------------------------------------------------------------------
# Name: FlowAccumulation_example02.py
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inFlowDirection = "https://myserver/rest/services/flowdir/ImageServer"
outputFlowAccumulation = "outFlowAccumulation2"
inWeight = ""
dataType = "DOUBLE"

# Execute Flow Accumulation raster analysis tool
arcpy.ra.FlowAccumulation(inFlowDirection, outputFlowAccumulation, inWeight, dataType)

Environnements

Taille de cellule, Étendue, 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