Disponible avec une licence 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. Si aucun champ n'est valide, le champ ObjectID (par exemple, OID ou FID) est utilisé par défaut.
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.
Syntaxe
SnapPourPoint (in_pour_point_data, in_accumulation_raster, snap_distance, {pour_point_field})| Paramètre | Explication | Type de données |
in_pour_point_data | Emplacements de point d'écoulement en entrée qui seront capturées. 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 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. Cette sortie est de type entier. | Raster |
Exemple de code
Exemple 1 d'utilisation de l'outil SnapPourPoint (fenêtre Python)
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")
Exemple 2 d'utilisation de l'outil SnapPourPoint (script autonome)
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")
Environnements
Informations de licence
- ArcGIS for Desktop Basic: Requis ArcGIS Spatial Analyst
- ArcGIS for Desktop Standard: Requis ArcGIS Spatial Analyst
- ArcGIS for Desktop Advanced: Requis ArcGIS Spatial Analyst