Fractionner des lignes par des points (Gestion des données)

Synthèse

Fractionne des entités linéaires en fonction des intersections ou de leur proximité avec des entités ponctuelles.

Utilisation

• Les attributs des entités en entrée seront conservés dans la classe d’entités ponctuelles en sortie. Les champs suivants sont ajoutés à la classe d’entités en sortie :

  • ORIG_FID : stocke les identifiants des entités en entrée.
  • ORIG_SEQ : stocke le numéro de séquence de chaque ligne en sortie en respectant l’ordre des segments à partir du sommet de départ de l’entité en entrée.

• Si la valeur du paramètre Rayon de recherche n’est pas spécifiée, le point le plus proche est utilisé pour fractionner l’entité linéaire. Autrement dit, lorsque plusieurs points coïncident avec la ligne, un seul des points est utilisé pour fractionner la ligne. Si la valeur du paramètre Rayon de recherche est spécifiée, tous les points situés dans le rayon de recherche sont utilisés pour fractionner la ligne.

• Pour obtenir des résultats précis, utilisez un système de coordonnées projetées pour les entrées. Vous pouvez utiliser l’outil Projeter pour projeter des données spatiales à partir d’un système de coordonnées géographiques vers un système de coordonnées projetées avant d’utiliser l’outil Fractionner des lignes par des points.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Entités linéaires en entrée à fractionner.	Feature Layer
Entités ponctuelles	Entités ponctuelles en entrée dont les localisations sont utilisées pour fractionner les lignes en entrée.	Feature Layer
Classe d’entités en sortie	Classe d’entités en sortie qui contient les lignes fractionnées.	Feature Class
Rayon de recherche (Facultatif)	Distance utilisée pour fractionner des lignes en fonction de leur proximité par rapport aux entités ponctuelles. Les points qui se trouvent au sein de la distance de recherche d’une ligne en entrée sont utilisés pour fractionner cette ligne à l’emplacement le plus proche du point sur le segment de ligne. Si ce paramètre n’est pas spécifié, le point unique le plus proche est utilisé pour fractionner l’entité linéaire. Si un rayon est spécifié, tous les points situés au sein du rayon de recherche sont utilisés pour fractionner la ligne.	Linear Unit

Python

arcpy.management.SplitLineAtPoint(in_features, point_features, out_feature_class, {search_radius})

Nom	Explication	Type de données
in_features	Entités linéaires en entrée à fractionner.	Feature Layer
point_features	Entités ponctuelles en entrée dont les localisations sont utilisées pour fractionner les lignes en entrée.	Feature Layer
out_feature_class	Classe d’entités en sortie qui contient les lignes fractionnées.	Feature Class
search_radius (Facultatif)	Distance utilisée pour fractionner des lignes en fonction de leur proximité par rapport aux entités ponctuelles. Les points qui se trouvent au sein de la distance de recherche d’une ligne en entrée sont utilisés pour fractionner cette ligne à l’emplacement le plus proche du point sur le segment de ligne. Si ce paramètre n’est pas spécifié, le point unique le plus proche est utilisé pour fractionner l’entité linéaire. Si un rayon est spécifié, tous les points situés au sein du rayon de recherche sont utilisés pour fractionner la ligne.	Linear Unit

Exemple de code

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

Cet exemple illustre l’exécution de la fonction SplitLineAtPoint dans une fenêtre Python.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.SplitLineAtPoint("streets.shp", "events.shp", 
                                  "splitline_out.shp", "20 Meters")

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

Cet exemple illustre l’utilisation d’un script Python pour exécuter la fonction SplitLineAtPoint.

# Name: SplitLineAtPoint_Example.py
# Description: Split line features based on near point features.

import arcpy

arcpy.env.workspace = "C:/data"
inFeatures = "streets.shp"
pointFeatures = "events.shp"
outFeatureclass = "splitline_out.shp"
searchRadius = "20 Meters"

arcpy.management.SplitLineAtPoint(inFeatures, pointFeatures, outFeatureclass, 
                                  searchRadius)

Environnements

Espace de travail courant, Étendue, Système de coordonnées en sortie, Résolution XY, Tolérance XY, Valeurs M en sortie, Résolution M, Tolérance M, Valeurs Z en sortie, Valeur Z en sortie par défaut, Résolution Z, Tolérance Z, Domaine M en sortie, Domaine Z en sortie