Étiquette | 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 |
Placement du point | Spécifie la méthode à utiliser pour échantillonner les points le long des entités linéaires 3D.
| 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é.
| 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.
| 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 |
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
arcpy.ddd.GeneratePointsAlong3DLines(in_feature, out_features, point_placement, {distance}, {percentage}, {include_end_points}, {add_chainage_fields}, {distance_field})
Nom | Explication | Type 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.
| 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é.
| 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
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
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?