Capture des points d’écoulement (Spatial Analyst)

Niveau de licence :De baseStandardAvancé

Récapitulatif

Capture les points d’écoulement dans la cellule d’accumulation de flux la plus élevée, selon une distance donnée.

Utilisation

Syntaxe

SnapPourPoint (in_pour_point_data, in_accumulation_raster, snap_distance, {pour_point_field})
ParamètreExplicationType 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

NomExplicationType 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

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

Thèmes connexes

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
9/13/2013