Capturer (Mise à jour)

Synthèse

Déplace des points ou sommets pour qu’ils coïncident exactement avec les sommets, segments ou extrémités d’autres entités. Des règles de capture peuvent être spécifiées afin d’indiquer si les sommets en entrée sont capturés sur le sommet, l’extrémité ou le segment le plus proche à une distance spécifiée.

Illustration

Utilisation

Attention :

Cet outil modifie les données en entrée. Pour plus d’informations et connaître les stratégies permettant d’empêcher les modifications de données indésirables, reportez-vous à la rubrique Outils qui modifient ou mettent à jour les données en entrée.

• L’environnement de capture permet la capture des sommets des entités en entrée sur les sommets, les segments et les extrémités de plusieurs couches ou classes d’entités. Si plusieurs règles de capture sont fournies, elles sont classées par ordre de priorité de haut en bas dans la boîte de dialogue de l’outil ou de gauche à droite dans les scripts.

• Les sommets des entités en entrée sont capturés sur le sommet, l’extrémité ou le segment le plus proche à une distance spécifiée.

• Vous pouvez spécifier plusieurs règles de capture pour une même couche ou classe d’entités avec une distance ou un type de capture différent.

• Si une couche d’entités avec une sélection ou un filtre est utilisée en entrée, seuls les sommets des entités sélectionnées sont capturés. Si une couche d’entités avec une sélection ou un filtre est utilisée comme entités de l’environnement de capture, la capture a lieu uniquement sur les entités sélectionnées.

• Lors de la capture d’entités d’une classe d’entités sur des entités de la même classe d’entités, l’entité possédant l’ID d’objet ou d’entité inférieur est habituellement capturée sur l’entité possédant l’ID d’objet supérieur. Si, par exemple, des points dont le champ OBJECTID a pour valeur 1 et 2 se trouvent dans la distance de capture, le point dont le champ OBJECTID a pour valeur 1 sera capturé sur l’emplacement du point dont le champ OBJECTID a pour valeur 2 (et pas l’inverse).

Remarque :

Cet outil sert notamment à réconcilier les différences entre les limites partagées ou communes de deux jeux de données, par capture des sommets d’une limite sur les sommets, segments ou extrémités de l’autre. Si les entités en entrée ne comportent pas suffisamment de sommets pour correspondre à la courbure exacte de l’autre limite, vous pouvez leur ajouter des sommets à l’aide de l’outil Densifier afin de permettre un niveau de détail supérieur.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Entités en entrée avec les sommets qui seront capturés sur les sommets, segments ou extrémités d’autres entités. Elles peuvent être de type point, multi-point, ligne ou polygone.	Feature Layer
Environnement de capture	Classes ou couches d’entités contenant les entités sur lesquelles la capture doit être effectuée. Les composants de l’environnement de capture sont les suivants : Entités : entités sur lesquelles les sommets des entités en entrée sont capturés. Ces entités peuvent être de type point, multi-point, ligne ou polygone. Type : type de la partie de l’entité sur laquelle les sommets des entités en entrée peuvent être capturés. Distance : distance à l’intérieur de laquelle les sommets des entités en entrée sont capturés sur l’extrémité, le sommet ou le segment le plus proche. Types de capture disponibles : Extrémité : les sommets des entités en entrée sont capturés sur les extrémités des entités. Sommet : les sommets des entités en entrée sont capturés sur les sommets des entités. Segment : les sommets des entités en entrée sont capturés sur les segments des entités. Remarque : Si une distance est utilisée sans unité (par exemple, 10 au lieu de 10 mètres), l’unité linéaire ou angulaire du système de coordonnées de l’entité en entrée est utilisée par défaut. Si les entités en entrée disposent d’un système de coordonnées projetées, l’unité linéaire est utilisée.	Value Table

Sortie obtenue

Étiquette	Explication	Type de données
Entités en entrée capturées	Entités en entrée mises à jour.	Feature Class

Python

arcpy.edit.Snap(in_features, snap_environment)

Nom	Explication	Type de données
in_features	Entités en entrée avec les sommets qui seront capturés sur les sommets, segments ou extrémités d’autres entités. Elles peuvent être de type point, multi-point, ligne ou polygone.	Feature Layer
snap_environment [[Features, Type, Distance],...]	Classes ou couches d’entités contenant les entités sur lesquelles la capture doit être effectuée. Les composants de l’environnement de capture sont les suivants : Entités : entités sur lesquelles les sommets des entités en entrée sont capturés. Ces entités peuvent être de type point, multi-point, ligne ou polygone. Type : type de la partie de l’entité sur laquelle les sommets des entités en entrée peuvent être capturés. Distance : distance à l’intérieur de laquelle les sommets des entités en entrée sont capturés sur l’extrémité, le sommet ou le segment le plus proche. Types de capture disponibles : END : les sommets des entités en entrée sont capturés sur les extrémités des entités. VERTEX : les sommets des entités en entrée sont capturés sur les sommets des entités. EDGE : les sommets des entités en entrée sont capturés sur les segments des entités. Remarque : Si une distance est utilisée sans unité (par exemple, 10 au lieu de 10 mètres), l’unité linéaire ou angulaire du système de coordonnées de l’entité en entrée est utilisée par défaut. Si les entités en entrée disposent d’un système de coordonnées projetées, l’unité linéaire est utilisée.	Value Table

Sortie obtenue

Nom	Explication	Type de données
out_feature_class	Entités en entrée mises à jour.	Feature Class

Exemple de code

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

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction Snap.

import arcpy
arcpy.env.workspace = "C:/data"

arcpy.edit.Snap("climate.shp", 
                [["Habitat_Analysis.gdb/vegtype", "VERTEX", "30 Feet"], 
                 ["Habitat_Analysis.gdb/vegtype", "EDGE", "20 Feet"]])

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

Capturer les limites des zones climatiques sur la limite de la couche de végétation afin de garantir que la limite commune coïncide.

# Description: Snap climate regions boundary to vegetation layer boundary 
#              to ensure common boundary is coincident

# Import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Make backup copy of climate regions feature class, since modification with
# the Editing tools below is permanent.
climate = "climate.shp"
climateBackup = "C:/output/Output.gdb/climateBackup"
arcpy.management.CopyFeatures(climate, climateBackup)

# Densify climate regions feature class to ensure there are enough vertices
# to match detail of vegetation layer when layers are snapped.
arcpy.edit.Densify(climate, "DISTANCE", "10 Feet")

# Snap climate regions feature class to  vegetation layer vertices and edge.
veg = "Habitat_Analysis.gdb/vegtype"

# First, snap climate region vertices to the nearest vegetation layer vertex
# within 30 feet.
snapEnv1 = [veg, "VERTEX", "30 Feet"]

# Second, snap climate region vertices to the nearest vegetation layer edge
# within 20 feet.
snapEnv2 = [veg, "EDGE", "20 Feet"]
arcpy.edit.Snap(climate, [snapEnv1, snapEnv2])

Environnements

Étendue, Espace de travail courant

Informations de licence

• Basic: Non
• Standard: Oui
• Advanced: Oui