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.
Si le paramètre Ajouter une distance cumulée et des champs de séquence est sélectionné, les champs suivants sont ajoutés :
- ORIG_LEN- La distance cumulée le long de la ligne à partir du point de début de la ligne et jusqu’au point. Les valeurs de distance sont ajoutées dans les unités de la référence spatiale de la valeur Entités en entrée.
- ORIG_SEQ- Le numéro de séquence de chaque point dans l’ordre des points créés à partir de chaque ligne 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
Ajouter une distance cumulée et des champs de séquence (Facultatif)	Indique si des champs de séquence et de distance cumulée sont ajoutés à la sortie. Sélectionné : les champs de distance cumulée (ORIG_LEN) et de séquence (ORIG_SEQ) sont ajoutés à la sortie. Les valeurs de distance sont ajoutées dans les unités de la référence spatiale de la valeur Entités en entrée. Désélectionné : les champs de distance cumulée et de séquence ne sont pas ajoutés à la sortie. 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}, {Add_Chainage_Fields})

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
Add_Chainage_Fields (Facultatif)	Indique si des champs de séquence et de distance cumulée sont ajoutés à la sortie. ADD_CHAINAGE—Les champs de distance cumulée (ORIG_LEN) et de séquence (ORIG_SEQ) sont ajoutés à la sortie. Les valeurs de distance sont ajoutées dans les unités de la référence spatiale de la valeur Input_Features. NO_CHAINAGE—Les champs de distance cumulée et de séquence ne sont pas ajoutés à la sortie. 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.management.GeneratePointsAlongLines('rivers', 'distance_intervals', 'DISTANCE', Distance='500 meters')
arcpy.management.GeneratePointsAlongLines('rivers', 'percentage_intervals', 'PERCENTAGE', Percentage=10)

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

Le script autonome ci-dessous illustre l’utilisation de la fonction 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'

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

# Run GeneratePointsAlongLines by percentage
arcpy.management.GeneratePointsAlongLines(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

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui