Capture des points d’écoulement (Spatial Analyst)
Récapitulatif
Capture les points d’écoulement dans la cellule d’accumulation de flux la plus élevée, selon une distance donnée.
Utilisation
-
L'outil Capture des points d'écoulement permet d'établir un sélection de points d'accumulation de flux élevée lorsque vous délimitez des bassins de drainage à l'aide de l'outil Bassins versants. L'outil Capture des points d'écoulement recherche, au sein d'un périmètre de capture autour des points d'écoulement spécifiés, la cellule qui présente l'accumulation de flux la plus élevée et déplace le point d'écoulement à cet emplacement.
-
Si les données de points d'écoulement en entrée sont une classe d'entités ponctuelles, elles seront converties en raster en interne pour les besoins du traitement.
-
La sortie est un raster d'entiers lorsque les emplacements de point d'écoulement originaux ont été capturés aux emplacements d'accumulation de flux la plus élevée.
-
Lorsqu'il existe un seul emplacement de point d'écoulement en entrée, l'étendue en sortie est celle du raster d'accumulation. S'il existe plusieurs emplacements de point d'écoulement, l'étendue en sortie est déterminée par les paramètres de l'environnement Etendue en sortie.
Lorsque vous spécifiez les emplacements des points d'écoulement en entrée comme données d'entité, le champ par défaut est le premier champ valide disponible. S'il n'existe aucun champ valide, le champ ObjectID (par exemple, OID ou FID) est utilisé par défaut.
Syntaxe
| Paramètre | Explication | Type de données |
in_pour_point_data |
Emplacements de point d'écoulement en entrée qui seront capturés. Pour une entrée raster, toutes les cellules dont la valeur n'est pas NoData (qui ont une valeur) sont considérées comme des points d'écoulement et sont capturées. Pour une entrée d'entité ponctuelle, ce paramètre spécifie l'emplacement des cellules qui sont capturées. | Raster Layer | Feature Layer |
in_accumulation_raster |
Raster d'accumulation de flux en entrée. Celui-ci peut être créé avec l'outil Accumulation de flux. | Raster Layer |
snap_distance |
Distance maximale (en unités de carte) de recherche d'une cellule d'accumulation de flux plus élevée. | Double |
pour_point_field (Facultatif) | Champ utilisé pour attribuer des valeurs aux emplacements de points d'écoulement. Si le jeu de données des points d'écoulement est un raster, utilisez la valeur. Si le jeu de données des points d'écoulement est une entité, utilisez un champ numérique. Si le champ contient des valeurs à virgule flottante, celles-ci sont remplacées par des entiers. | Field |
Valeur renvoyée
| Nom | Explication | Type de données |
| out_raster |
La sortie est un raster d'entiers de points d'écoulement lorsque les emplacements de point d'écoulement originaux ont été capturés aux emplacements d'accumulation de flux la plus élevée. | Raster |
Exemple de code
Dans cet exemple, la capture des points d’écoulement s'effectue dans la cellule d’accumulation de flux la plus élevée, selon une distance donnée.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outSnapPour = SnapPourPoint("pourpoint", "flowaccumulation.img", 5,"VALUE")
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt01")
Dans cet exemple, la capture des points d’écoulement s'effectue dans la cellule d’accumulation de flux la plus élevée, selon une distance donnée.
# Name: SnapPourPoints_Ex_02.py
# Description: Snaps pour points to the cell of highest
# flow accumulation within a specified distance.
# 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
inPourPoint = "pourpoint"
inFlowAccum = "flowaccumulation.img"
tolerance = 5
pourField = "VALUE"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute SnapPourPoints
outSnapPour = SnapPourPoint(inPourPoint, inFlowAccum, tolerance,
pourField)
# Save the output
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt02")