Générer des points le long de lignes 3D (3D Analyst)

Synthèse

Crée des entités ponctuelles 3D le long de lignes 3D à l’aide de distances tridimensionnelles.

Utilisation

  • Cet outil génère des entités ponctuelles 3D le long de lignes 3D en utilisant des distances tridimensionnelles pour mesurer la distance à laquelle créer les points. S’il faut calculer à l’aide de distances bidimensionnelles les points échantillonnés à partir de la ligne 3D le long du plan x,y, utilisez plutôt l’outil Générer des points le long des lignes.

  • 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.

  • The attributes of the input features will be maintained in the output feature class. A new field, ORIG_FID, will be added to the output feature class and set to the input feature IDs.

  • 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 de la ligne 3D utilisées pour créer les points.

Feature Layer
Classe d’entités en sortie

Entités ponctuelles 3D créées à partir des lignes en entrée.

Feature Class
Placement du point

Spécifie la méthode à utiliser pour échantillonner les points le long des entités linéaires 3D.

  • 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.
  • Par pourcentageLa valeur du paramètre Pourcentage est utilisée pour placer des points le long des entités par pourcentage.
  • Par champ de distanceLes 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

arcpy.ddd.GeneratePointsAlong3DLines(in_feature, out_features, point_placement, {distance}, {percentage}, {include_end_points}, {add_chainage_fields}, {distance_field})
NomExplicationType de données
in_feature

Entités de la ligne 3D utilisées pour créer les points.

Feature Layer
out_features

Entités ponctuelles 3D créées à partir des lignes en entrée.

Feature Class
point_placement

Spécifie la méthode à utiliser pour échantillonner les points le long des entités linéaires 3D.

  • 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.
  • DISTANCE_FIELDLes valeurs de champ de la valeur de paramètre distance_field sont 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 point_placement a pour valeur DISTANCE_FIELD.

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_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)
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

Exemple de code

Exemple d’utilisation de l’outil GeneratePointsAlong3DLines (fenêtre Python)

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python :


import arcpy
arcpy.env.workspace = 'C:/data'
arcpy.ddd.GeneratePointsAlong3DLines("hiking_trail.shp", "evaluation_points.shp", "PERCENTAGE"
                                      percentage=5, add_chainage_fields="ADD_CHAINAGE")

Rubriques connexes