Accumulation de flux (Analyse raster)

Synthèse

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

Illustration

Illustration de l’outil Accumulation de flux

Utilisation

  • Cet outil de portail d’analyse raster est disponible lorsque vous êtes connecté à un portail ArcGIS Enterprise disposant d’un ArcGIS Image Server configuré pour Analyse raster. Lorsque cet outil est appelé, ArcGIS Pro est utilisé comme client et le traitement est effectué dans les serveurs fédérés avec ArcGIS Enterprise. Cet outil du portail prend en charge les couches de votre portail en entrée et crée la sortie dans le portail.

    La couche raster en entrée prend en charge les éléments suivants : couche du portail, URI ou URL d’un service d’imagerie ou sortie de l’outil Créer une couche de serveur d’imagerie. Cet outil ne prend pas en charge les données raster ou les couches 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

ÉtiquetteExplicationType 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 des méthodes D8, MFD ou DINF. Utilisez le paramètre Flow Direction Type (Type de direction de flux) pour spécifier la méthode utilisée lors de la création du raster de direction de flux.

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.

  • FlottantLe raster en sortie contient toujours des valeurs à virgule flottante. Il s’agit de l’option par défaut.
  • EntierLe raster en sortie sera un entier.
  • DoubleLe raster en sortie sera de type double.
String
Type de direction de flux
(Facultatif)

Spécifie le type de raster de direction de flux en entrée.

  • 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

Sortie obtenue

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie.

Raster Layer

arcpy.ra.FlowAccumulation(inputFlowDirectionRaster, outputName, {inputWeightRaster}, {dataType}, {flowDirectionType})
NomExplicationType 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 des méthodes 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 direction de flux.

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.

  • 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
flowDirectionType
(Facultatif)

Spécifie le type de raster de direction de flux en entrée.

  • 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

Sortie obtenue

NomExplicationType 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)

Informations de licence

  • Basic: Nécessite ArcGIS Image Server
  • Standard: Nécessite ArcGIS Image Server
  • Advanced: Nécessite ArcGIS Image Server

Rubriques connexes