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

Résumé

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. Si les points échantillonnés à partir de la ligne 3D doivent être calculés en utilisant des distances bidimensionnelles le long du plan x,y, utilisez plutôt l’outil Generate Points Along Lines (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 Point Placement (Positionnement des points) pour spécifier la méthode à utiliser pour placer les points en sortie.
Les attributs des entités en entrée seront conservés dans la classe d’entités ponctuelles en sortie. Un nouveau champ, ORIG_FID, sera ajouté à la classe d’entités en sortie et défini sur les ID d’entité en entrée.
Si le paramètre Add accumulated distance and sequence fields (Ajouter des champs de séquence et de distance cumulée) est sélectionné, les champs suivants sont ajoutés :
- ORIG_LEN—Distance cumulée le long de la ligne depuis le point de début de la ligne jusqu’au point. Les valeurs de distance sont ajoutées dans les unités de la référence spatiale de la valeur Input Features (Entités en entrée).
- ORIG_SEQ—Numéro de séquence de chaque point dans l’ordre des points créés à partir de chaque ligne en entrée.

Etiqueter	Explication	Type 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
Positionnement des points (Facultatif)	Spécifie la méthode à utiliser pour échantillonner les points le long des entités linéaires 3D. By Percentage—The Distance parameter value will be used to place points at fixed distances along the features. This is the default. By Distance—The Percentage parameter value will be used to place points along the features by percentage. By Distance Field—Field values from the Distance Field parameter value will be used to place points along the features.	String
Distance (Facultatif)	Intervalle depuis le début de l’entité en fonction duquel les points sont positionnés. Ce paramètre est actif lorsque le paramètre Point Placement (Positionnement des points) est défini sur By distance (Par distance).	Linear Unit
Pourcentage (Facultatif)	Pourcentage depuis le début de l’entité en fonction duquel les points sont positionnés. Par exemple, avec un pourcentage de 40, les points sont positionné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 (Positionnement des points) est défini sur By Percentage (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é—Additional points will be included at the start point and end point of the feature. Décoché—No additional points will be included at the start point and end point of the feature. This is the default.	Boolean
Ajouter des champs de séquence et de distance cumulée (Facultatif)	Indique si des champs de séquence et de distance cumulée sont ajoutés à la sortie. Activé—The accumulated distance (`ORIG_LEN`) and sequence (`ORIG_SEQ`) fields will be added to the output. Distance values are added in the units of the Input Features parameter value's spatial reference. Décoché—The accumulated distance and sequence fields will not be added to the output. This is the default.	Boolean
Champ de 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 Point Placement (Positionnement des points) est défini sur By Distance Field (Par champ de distance).	Field

arcpy.3d.GeneratePointsAlong3DLines(in_features, out_features, {point_placement}, {distance}, {percentage}, {include_end_points}, {add_chainage_fields}, {distance_field})

Nom	Explication	Type de données
in_features	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 (Facultatif)	Spécifie la méthode à utiliser pour échantillonner les points le long des entités linéaires 3D. `PERCENTAGE`—The `percentage` parameter value will be used to place points along the features by percentage. `DISTANCE`—The `distance` parameter value will be used to place points at fixed distances along the features. This is the default. `DISTANCE_FIELD`—Field values from the `distance_field` parameter value will be used to place points along the features.	String
distance (Facultatif)	Intervalle depuis le début de l’entité en fonction duquel les points sont positionnés. Ce paramètre est actif lorsque le paramètre `point_placement` est défini sur `DISTANCE_FIELD`.	Linear Unit
percentage (Facultatif)	Pourcentage depuis le début de l’entité en fonction duquel les points sont positionnés. Par exemple, avec un pourcentage de 40, les points sont positionné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` est défini sur `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`—Additional points will be included at the start point and end point of the feature. `NO_END_POINTS`—No additional points will be included at the start point and end point of the feature. This is the default.	Boolean
add_chainage_fields (Facultatif)	Indique si des champs de séquence et de distance cumulée sont ajoutés à la sortie. `ADD_CHAINAGE`—The accumulated distance (`ORIG_LEN`) and sequence (`ORIG_SEQ`) fields will be added to the output. Distance values are added in the units of the `in_features` parameter value's spatial reference. `NO_CHAINAGE`—The accumulated distance and sequence fields will not be added to the output. This is the default.	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` est défini sur `DISTANCE_FIELD`.	Field

Exemple de code

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

Environnements

Espace de travail courant, Système de coordonnées en sortie, Transformations géographiques, Mot-clé CONFIG en sortie, Domaine M en sortie, Domaine XY en sortie, Domaine Z en sortie, Résolution XY, Tolérance XY, Résolution Z, Tolérance Z, Étendue

Informations de licence