Flux focal (ArcGIS 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.

En savoir plus sur le fonctionnement de l’outil Flux focal

Illustration

OutRas = FocalFlow(InRas1)

Utilisation

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

• Les valeurs obtenues grâce à l’outil permettent de mesurer le flux en entrée dans la cellule (et non en sortie de celle-ci).

• 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

Boîte de dialogue

Étiquette	Explication	Type de données
Raster de surface en entrée	Raster de surface en entrée pour lequel le flux focal doit être calculé. Le système évalue les huit voisins immédiats de chaque cellule pour calculer le flux. Le raster en entrée peut être de type entier ou à virgule flottante.	Raster Layer
Valeur de seuil (Facultatif)	Définit une valeur qui constitue le seuil à atteindre ou dépasser avant que le flux se produise. Cette valeur de 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 de seuil, le résultat est 0 (ou absence de flux).	Double

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Raster de flux focal en sortie. Le raster en sortie est toujours de type entier.	Raster

Python

FocalFlow(in_surface_raster, {threshold_value})

Nom	Explication	Type de données
in_surface_raster	Raster de surface en entrée pour lequel le flux focal doit être calculé. Le système évalue les huit voisins immédiats de chaque cellule pour calculer le flux. Le raster en entrée peut être de type entier ou à virgule flottante.	Raster Layer
threshold_value (Facultatif)	Définit une valeur qui constitue le seuil à atteindre ou dépasser avant que le flux se produise. Cette valeur de 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 de seuil, le résultat est 0 (ou absence de flux).	Double

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Raster de flux focal en sortie. Le raster en sortie est toujours de type entier.	Raster

Exemple de code

Exemple 1 d’utilisation de la fonction FocalFlow (fenêtre Python)

Cet exemple détermine la représentation binaire d’un flux pour 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")

Exemple 2 d’utilisation de la fonction FocalFlow (script autonome)

Cet exemple détermine la représentation binaire d’un flux pour 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")

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Compression, Espace de travail courant, Étendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Espace de travail temporaire, Raster de capture, Taille de tuile