Générer des transects le long des lignes (Outils de gestion des données)

Résumé

Crée des transects perpendiculaires selon un intervalle régulier le long des lignes.

Utilisation

Cet outil fonctionne mieux lorsque les entités en entrée possèdent un système de coordonnées projetées approprié aux mesures des distances dans une surface locale. Les systèmes de coordonnées localisés, équidistants ou UTM conviennent parfaitement pour mesurer les distances. Les systèmes de coordonnées qui déforment la distance pour fournir davantage de formes cartographiques, tels que Web Mercator, ou les systèmes de coordonnées géographiques, risquent de ne pas générer des résultats exacts.
La sortie de cet outil comporte un seul attribut, ORIG_FID, qui stocke l’ID d’objet de l’entité en entrée le long de laquelle chaque transect a été généré. Vous pouvez utiliser ce champ pour ajouter des attributs supplémentaires issus des entités en entrée aux transects en sortie en exécutant l’outil Add Join (Ajouter une jointure) ou Join Field (Champ de jointure).

Etiqueter	Explication	Type de données
Entités en entrée	Entités linéaires le long desquelles les transects perpendiculaires sont générés.	Feature Layer
Classe d’entités en sortie	Transects perpendiculaires en sortie générés le long des entités en entrée.	Feature Class
Distance entre les transects	Intervalle depuis le début de l’entité en fonction duquel les transects sont placés.	Linear Unit
Longueur de transect	Longueur ou largeur du transect. Chaque transect est placé de telle façon le long de la ligne en entrée que la moitié de sa longueur se trouve sur un côté de la ligne et que l’autre moitié de sa longueur se trouve de l’autre côté de la ligne. Il s’agit de la longueur totale de chaque transect, et non de la distance sur laquelle le transect s’étend à partir de la ligne en entrée. Pour indiquer l’étendue souhaitée du transect à partir de la ligne en entrée (par exemple, 100 mètres), doublez cette valeur pour spécifier la longueur du transect (200 mètres).	Linear Unit
Générer des transects en début et en fin de ligne (Facultatif)	Indique si des transects sont générés au début et à la fin de la ligne en entrée. Activé—Des transects sont générés au début et à la fin de la ligne en entrée. Décoché—Aucun transect n’est généré au début et à la fin de la ligne en entrée. Il s’agit de l’option par défaut.	Boolean

arcpy.management.GenerateTransectsAlongLines(in_features, out_feature_class, interval, transect_length, {include_ends})

Nom	Explication	Type de données
in_features	Entités linéaires le long desquelles les transects perpendiculaires sont générés.	Feature Layer
out_feature_class	Transects perpendiculaires en sortie générés le long des entités en entrée.	Feature Class
interval	Intervalle depuis le début de l’entité en fonction duquel les transects sont placés.	Linear Unit
transect_length	Longueur ou largeur du transect. Chaque transect est placé de telle façon le long de la ligne en entrée que la moitié de sa longueur se trouve sur un côté de la ligne et que l’autre moitié de sa longueur se trouve de l’autre côté de la ligne. Il s’agit de la longueur totale de chaque transect, et non de la distance sur laquelle le transect s’étend à partir de la ligne en entrée. Pour indiquer l’étendue souhaitée du transect à partir de la ligne en entrée (par exemple, 100 mètres), doublez cette valeur pour spécifier la longueur du transect (200 mètres).	Linear Unit
include_ends (Facultatif)	Indique si des transects sont générés au début et à la fin de la ligne en entrée. `END_POINTS`—Des transects sont générés au début et à la fin de la ligne en entrée. `NO_END_POINTS`—Aucun transect n’est généré au début et à la fin de la ligne en entrée. Il s’agit de l’option par défaut.	Boolean

Exemple de code

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

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction GenerateTransectsAlongLines en mode immédiat.

import arcpy
arcpy.env.workspace = 'C:/data/base.gdb'
arcpy.management.GenerateTransectsAlongLines('rivers', 'river_sample_transects',
                                             '100 Meters', '100 Meters',
                                             'NO_END_POINTS')

Exemple 2 d’utilisation de la fonction GenerateTransectsAlongLines (script autonome)

Le script autonome ci-après illustre l’utilisation de la fonction GenerateTransectsAlongLines.

# Description: Add sampling perpendicular transect lines along a river

import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data/base.gdb'

# Set local variables
in_features = 'rivers'
out_fc_1 = 'river_samples_transects'

# Run GeneratePointsAlongLines by distance
arcpy.management.GenerateTransectsAlongLines(in_features, out_fc_1, '100 Meters',
                                             '100 meters', 'END_POINTS')

Environnements

Espace de travail courant

Informations de licence