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

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

ÉtiquetteExplicationType 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 pourcentageLa valeur du paramètre Pourcentage est utilisée pour placer des points le long des entités par pourcentage.
  • Par distanceLa 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})
NomExplicationType 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.

  • PERCENTAGELa valeur du paramètre Percentage est utilisée pour placer des points le long des entités par pourcentage.
  • DISTANCELa 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_POINTSDes points supplémentaires sont inclus au point de départ et à l’extrémité de l’entité.
  • NO_END_POINTSAucun 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_CHAINAGELes 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_CHAINAGELes 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')

Rubriques connexes