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.

Utilisation

Les points peuvent être placés selon un intervalle fixe pour toutes les entités ou le long d’entités par pourcentage de la longueur de l’entité. Ils peuvent également être placés en fonction d’un champ de l’entrée ; le champ peut représenter un intervalle fixe pour chaque entité ou des distances spécifiques pour chaque entité.
Utilisez le paramètre Placement du point pour spécifier la méthode qui sera utilisée pour placer les points en sortie.
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 à utiliser pour placer les 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 à utiliser pour placer les 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. Par champ de distance—Les valeurs de champ de la valeur de paramètre Champ de distance seront utilisées pour placer les points le long des entités.	String
Distance (Facultatif)	Intervalle depuis le début de l’entité en fonction duquel les points sont placés. Ce paramètre est actif lorsque le paramètre Placement du point a pour valeur Par distance.	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é. Ce paramètre est actif lorsque le paramètre Placement du point a pour valeur Par pourcentage.	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
Champ Distance (Facultatif)	Champ des entités en entrée à utiliser pour placer les points en sortie. Si le champ est de type numérique, la valeur du champ est utilisée pour placer des points à cet intervalle. Si le champ est de type chaîne, les valeurs du champ doivent être organisées sous forme de chaîne de distances séparées par un point-virgule. Les points sont placés à ces distances. Les valeurs du champ égales à zéro ou négatives sont ignorées. Les valeurs du champ supérieures à la longueur d’une entité sont ignorées pour cette entité. Les distances sont exprimées dans les unités linéaires de la référence spatiale de l’entrée. Ce paramètre est actif lorsque le paramètre Placement du point a pour valeur Par champ de distance.	Field
Méthode de distance (Facultatif)	Spécifie la méthode de mesure qui sera utilisée pour créer les points. Ce paramètre est actif lorsque le paramètre Placement du point a pour valeur Par distance. Planaire—Les points sont créés à l’aide de la méthode planaire. Les mesures planaires utilisent des mathématiques cartésiennes en 2D. Il s’agit de l’option par défaut. Géodésique—Les points sont créés à l’aide de la méthode géodésique. Les mesures géodésiques calculent la distance entre deux points sur la surface de la Terre. Il s’agit de l’option par défaut lorsque l’entrée possède un système de coordonnées géographiques.	String

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

Nom	Explication	Type de données
Input_Features	Entités linéaires ou surfaciques à utiliser pour placer les 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 à utiliser pour placer les 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. DISTANCE_FIELD—Les valeurs de champ de la valeur de paramètre Distance_Field seront utilisées pour placer les points.	String
Distance (Facultatif)	Intervalle depuis le début de l’entité en fonction duquel les points sont placés. Ce paramètre est actif lorsque le paramètre Point_Placement a pour valeur DISTANCE.	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é. Ce paramètre est actif lorsque le paramètre Point_Placement a pour valeur PERCENTAGE.	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
Distance_Field (Facultatif)	Champ des entités en entrée à utiliser pour placer les points en sortie. Si le champ est de type numérique, la valeur du champ est utilisée pour placer des points à cet intervalle. Si le champ est de type chaîne, les valeurs du champ doivent être organisées sous forme de chaîne de distances séparées par un point-virgule. Les points sont placés à ces distances. Les valeurs du champ égales à zéro ou négatives sont ignorées. Les valeurs du champ supérieures à la longueur d’une entité sont ignorées pour cette entité. Les distances sont exprimées dans les unités linéaires de la référence spatiale de l’entrée. Ce paramètre est actif lorsque le paramètre Point_Placement a pour valeur DISTANCE_FIELD.	Field
Distance_Method (Facultatif)	Spécifie la méthode de mesure qui sera utilisée pour créer les points. Ce paramètre est actif lorsque le paramètre Point_Placement a pour valeur DISTANCE. PLANAR—Les points sont créés à l’aide de la méthode planaire. Les mesures planaires utilisent des mathématiques cartésiennes en 2D. Il s’agit de l’option par défaut. GEODESIC—Les points sont créés à l’aide de la méthode géodésique. Les mesures géodésiques calculent la distance entre deux points sur la surface de la Terre. Il s’agit de l’option par défaut lorsque l’entrée possède un système de coordonnées géographiques.	String

Exemple de code

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

Le script ci-dessous pour la fenêtre Python montre comment utiliser 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)
arcpy.management.GeneratePointsAlongLines('rivers', 'distance_by_field', 'DISTANCE_FIELD', Distance_Field='distance')

Exemple 2 d’utilisation de la fonction 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')

# Run GeneratePointsAlongLines by distance field
arcpy.management.GeneratePointsAlongLines(in_features, out_fc_2, 'DISTANCE_FIELD',
                                          Distance_Field='distance')

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

Rubriques connexes

Vous avez un commentaire à formuler concernant cette rubrique ?