Générer des points le long des lignes (Gestion des données)—ArcGIS Pro

Synthèse

Crée des entités ponctuelles le long de lignes ou de polygones à des intervalles fixes ou par pourcentage de la longueur d’une entité.

Utilisation

Les attributs des entités en entrée seront conservés dans la classe d'entités points en sortie. Un nouveau champ, ORIG_FID, sera ajouté à la classe d'entités en sortie et défini sur les identifiants d'entité en entrée.

Paramètres

Étiquette	Explication	Type de données
Entités en entrée	Entités linéaires ou surfaciques à convertir en points.	Feature Layer
Classe d’entités en sortie	Classe d'entités ponctuelles qui sera créée à partir des entités en entrée.	Feature Class
Placement du point	Spécifie la méthode utilisée pour créer des points. Par pourcentage—La valeur du paramètre Pourcentage est utilisée pour placer des points le long des entités par pourcentage. Par distance—La valeur du paramètre Distance est utilisée pour placer des points à des distances fixes le long des entités. Il s’agit de l’option par défaut.	String
Distance (Facultatif)	Intervalle depuis le début de l’entité en fonction duquel les points sont placés.	Linear Unit
Pourcentage (Facultatif)	Pourcentage depuis le début de l'entité en fonction duquel les points sont placés. Par exemple, avec un pourcentage de 40, les points sont placés à 40 pour cent et 80 pour cent de la distance de l’entité.	Double
Inclure les extrémités (Facultatif)	Indique si des points supplémentaires sont inclus au point de départ et à l’extrémité de l’entité. Activé : des points supplémentaires sont inclus au point de départ et à l’extrémité de l’entité. Désactivé : aucun point supplémentaire n’est inclus au point de départ et à l’extrémité de l’entité. Il s’agit de l’option par défaut.	Boolean

arcpy.management.GeneratePointsAlongLines(Input_Features, Output_Feature_Class, Point_Placement, {Distance}, {Percentage}, {Include_End_Points})

Nom	Explication	Type de données
Input_Features	Entités linéaires ou surfaciques à convertir en points.	Feature Layer
Output_Feature_Class	Classe d'entités ponctuelles qui sera créée à partir des entités en entrée.	Feature Class
Point_Placement	Spécifie la méthode qui sera utilisée pour créer des points. PERCENTAGE—La valeur du paramètre Percentage est utilisée pour placer des points le long des entités par pourcentage. DISTANCE—La valeur du paramètre Distance est utilisée pour placer des points à des distances fixes le long des entités. Il s’agit de l’option par défaut.	String
Distance (Facultatif)	Intervalle depuis le début de l’entité en fonction duquel les points sont placés.	Linear Unit
Percentage (Facultatif)	Pourcentage depuis le début de l'entité en fonction duquel les points sont placés. Par exemple, avec un pourcentage de 40, les points sont placés à 40 pour cent et 80 pour cent de la distance de l’entité.	Double
Include_End_Points (Facultatif)	Indique si des points supplémentaires sont inclus au point de départ et à l’extrémité de l’entité. END_POINTS—Des points supplémentaires sont inclus au point de départ et à l’extrémité de l’entité. NO_END_POINTS—Aucun point supplémentaire n’est inclus au point de départ et à l’extrémité de l’entité. Il s’agit de l’option par défaut.	Boolean

Exemple de code

Exemple 1 d'utilisation de l'outil GeneratePointsAlongLines (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction GeneratePointsAlongLines en mode immédiat.

import arcpy
arcpy.env.workspace = 'C:/data/base.gdb'
arcpy.GeneratePointsAlongLines_management('rivers', 'distance_intervals', 'DISTANCE', Distance='500 meters')
arcpy.GeneratePointsAlongLines_management('rivers', 'percentage_intervals', 'PERCENTAGE', Percentage=10)

Exemple 2 d'utilisation de l'outil GeneratePointsAlongLines (script autonome)

Le script autonome suivant illustre l’utilisation de l’outil GeneratePointsAlongLines.

# Description: Convert point features to line features

import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data/base.gdb'

# Set local variables
in_features = 'rivers'
out_fc_1 = 'distance_intervals'
out_fc_2 = 'percentage_intervals'

# Execute GeneratePointsAlongLines by distance
arcpy.GeneratePointsAlongLines_management(in_features, out_fc_1, 'DISTANCE',
                                          Distance='500 meters')

# Execute GeneratePointsAlongLines by percentage
arcpy.GeneratePointsAlongLines_management(in_features, out_fc_2, 'PERCENTAGE',
                                          Percentage=10,
                                          Include_End_Points='END_POINTS')

Environnements

Espace de travail courant, Mot-clé CONFIG en sortie, Valeurs M en sortie, Valeurs Z en sortie

Cas particuliers

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui