Résumé
Supprime les portions d’une ligne qui se prolongent selon une distance spécifiée au-delà d’une intersection de lignes (arcs pendants). Toute ligne qui ne touche pas une autre ligne aux deux extrémités peut être tronquée, mais seule la portion de la ligne qui se prolonge au-delà de l’intersection selon la distance spécifiée est supprimée.
L’outil est destiné à des tâches de contrôle qualité, telles que le nettoyage des erreurs de topologie dans des entités qui ont été numérisées sans que des environnements de capture appropriés n’aient été définis.
Illustration
Utilisation
Toute ligne qui ne touche pas une autre ligne aux deux extrémités peut être tronquée. Deux types de ligne remplissent cette condition :
- Arc pendant d’une ligne. Un arc pendant est la portion d’une ligne qui se situe entre le point où elle touche ou intersecte une autre ligne et son extrémité (la fin de la ligne qui ne touche pas ou qui ne se termine pas sur une autre ligne).
- Entité autonome. Cette entité ne touche ou n’intersecte aucune autre ligne. Pour supprimer ces entités, vous devez utiliser l’option Supprimer les entités courtes.
Si aucune longueur d’arc pendant n’est spécifiée, toutes les lignes pendantes (segments de ligne qui ne touchent pas une autre ligne aux deux extrémités), quelle que soit leur longueur, sont tronquées sur le point d’intersection.
Si l’option Supprimer les entités courtes est utilisée, les entités autonomes dont la longueur totale est inférieure ou égale à la longueur d’arc pendant spécifiée sont supprimées. Si cette option n’est pas utilisée, seuls les segments de ligne pendants sont tronqués.
Si une couche d’entités ou une classe d’entités avec une sélection est utilisée en entrée, seules les entités sélectionnées sont tronquées. Toutes les entités au sein de la couche d’entités ou de la classe d’entités sont utilisées pour déterminer si un arc pendant est présent et doit être supprimé, mais seules les entités sélectionnées sont modifiées.
Cet outil ne modifie pas les attributs des entités, à l’exception des champs géométriques (longueur) dans une classe d’entités de géodatabase.
Syntaxe
arcpy.edit.TrimLine(in_features, {dangle_length}, {delete_shorts})
Paramètre | Explication | Type de données |
in_features | Entités linéaires en entrée à tronquer. | Feature Layer |
dangle_length (Facultatif) | Les segments de ligne dont la longueur est inférieure à la longueur d’arc pendant spécifiée et qui ne touchent pas une autre ligne aux deux extrémités (arcs pendants) sont tronqués. Si aucune longueur d’arc pendant n’est spécifiée, toutes les lignes pendantes (segments de ligne qui ne touchent pas une autre ligne aux deux extrémités), quelle que soit leur longueur, sont tronquées sur le point d’intersection. | Linear Unit |
delete_shorts (Facultatif) | Indique si les segments de ligne autonomes dont la longueur est inférieure à la longueur d’arc pendant sont supprimés.
| Boolean |
Sortie dérivée
Nom | Explication | Type de données |
out_feature_class | Entités en entrée mises à jour. | Feature Class |
Exemple de code
Exemple 1 d’utilisation de la fonction TrimLine (fenêtre Python)
Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction TrimLine.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.TrimLine_edit("majorrds.shp", "15 Feet", "DELETE_SHORT")
Exemple 2 d’utilisation de la fonction TrimLine (script autonome)
Nettoyer les axes médians des rues qui ont été numérisés sans que des environnements de capture appropriés n’aient été définis.
# Name: ExtendLine.py
# Description: Clean up street centerlines that were digitized without
# having set proper snapping environments
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Make backup copy of streets feature class, since modification with
# the Editing tools below is permanent
streets = "majorrds.shp"
streetsBackup = "C:/output/Output.gdb/streetsBackup"
arcpy.CopyFeatures_management(streets, streetsBackup)
# Trim street lines to clean up dangles
arcpy.TrimLine_edit(streets, "10 Feet", "KEEP_SHORT")
# Extend street lines to clean up dangles
arcpy.ExtendLine_edit(streets, "15 Feet", "EXTENSION")
Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui