Flux focal (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Calcule le flux des valeurs du raster en entrée dans le voisinage immédiat de chaque cellule.

Pour en savoir plus sur le fonctionnement de l'outil Flux focal

Illustration

Illustration de l'outil Flux focal
OutRas = FocalFlow(InRas1)

Utilisation

  • L'outil Flux focal permet d'évaluer les huit voisins immédiats d'une cellule afin de déterminer le flux.

  • Les valeurs que vous obtenez permettent de mesurer le flux en entrée dans la cellule (et non l'inverse).

  • Les valeurs en sortie découlent de la représentation binaire des résultats de l'analyse.

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

Paramètres

ÉtiquetteExplicationType de données
Raster de surface en entrée

Raster de surface en entrée dont vous souhaitez calculer le flux focal.

Le système évalue les huit voisins immédiats de chaque cellule pour calculer le flux.

Le raster en entrée peut être un entier ou à virgule flottante.

Raster Layer
Seuil
(Facultatif)

Définit une valeur qui correspond au seuil. Vous devez atteindre cette valeur ou la dépasser avant le flux.

Ce seuil est un entier ou une valeur à virgule flottante.

Si la différence entre la valeur à l'emplacement d'une cellule voisine et la valeur de la cellule de traitement est inférieure ou égale à la valeur du seuil, le résultat est 0 (ou pas de flux).

Double

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Raster de flux focal en sortie.

Le raster en sortie est toujours un entier.

Raster

FocalFlow(in_surface_raster, {threshold_value})
NomExplicationType de données
in_surface_raster

Raster de surface en entrée dont vous souhaitez calculer le flux focal.

Le système évalue les huit voisins immédiats de chaque cellule pour calculer le flux.

Le raster en entrée peut être un entier ou à virgule flottante.

Raster Layer
threshold_value
(Facultatif)

Définit une valeur qui correspond au seuil. Vous devez atteindre cette valeur ou la dépasser avant le flux.

Ce seuil est un entier ou une valeur à virgule flottante.

Si la différence entre la valeur à l'emplacement d'une cellule voisine et la valeur de la cellule de traitement est inférieure ou égale à la valeur du seuil, le résultat est 0 (ou pas de flux).

Double

Valeur renvoyée

NomExplicationType de données
out_raster

Raster de flux focal en sortie.

Le raster en sortie est toujours un entier.

Raster

Exemple de code

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

Cet exemple indique la représentation binaire d'un flux dans le raster en entrée avec une valeur de seuil de 10.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
focalFlowOut = FocalFlow("elevation", 10)
focalFlowOut.save("C:/sapyexamples/output/flowout")
Deuxième exemple d'utilisation de l'outil FocalFlow (script autonome)

Cet exemple indique la représentation binaire d'un flux dans le raster en entrée avec une valeur de seuil de 5.

# Name: FocalFlow_Ex_02.py
# Description: Determines the flow of the values in the 
#    input raster within each cell's immediate neighborhood.
# 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
inRaster = "elevation"
threshold = 5 

# Execute FocalFlow
outFocalFlow = FocalFlow(inRaster, threshold)

# Save the output 
outFocalFlow.save("C:/sapyexamples/output/focalflow")

Informations de licence

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

Rubriques connexes