Capture des points d’écoulement (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

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.

  • Lorsque le format raster en sortie est .crf, cet outil prend en charge l’environnement de stockage raster Pyramide. Des pyramides seront créées dans la sortie par défaut. Pour tout autre format en sortie, cet environnement n’est pas pris en charge et aucune pyramide n’est créée.

  • 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
Données de point d’écoulement d’entité ou de raster en entrée

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
Raster d’accumulation en entrée

Raster d'accumulation de flux en entrée.

Celui-ci peut être créé avec l'outil Accumulation de flux.

Raster Layer
Distance de capture

Distance maximale (en unités de carte) de recherche d'une cellule d'accumulation de flux plus élevée.

Double
Champ de point d’écoulement
(Facultatif)

Le 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 Value.

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

ÉtiquetteExplicationType de données
Raster en sortie

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

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

Le 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 Value.

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 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"

# Execute SnapPourPoints
outSnapPour = SnapPourPoint(inPourPoint, inFlowAccum, tolerance, 
                            pourField) 

# Save the output 
outSnapPour.save("c:/sapyexamples/output/outsnpprpnt02")

Rubriques connexes