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 conformément à 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 topologiques 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 Delete Short Features (Supprimer les entités courtes).
Si aucune longueur d’arc pendant (champ Dangle Length) 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 la longueur, sont à nouveau tronquées sur le point d’intersection.
Si l’option Delete Short Features (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 d'entités, à l'exception des champs géométriques (longueur) dans une classe d'entités de géodatabase.
Attention :
Cet outil modifie les données en entrée. Pour plus d’informations et connaître les stratégies permettant d’empêcher les modifications de données indésirables, reportez-vous à la rubrique Outils qui modifient ou mettent à jour les données en entrée.
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 la longueur, sont à nouveau tronquées sur le point d'intersection. | Linear Unit |
delete_shorts (Facultatif) | Indique si les segments de ligne qui sont inférieurs à la longueur d'arc pendant et autonomes sont supprimés.
| Boolean |
Sortie dérivée
Nom | Explication | Type de données |
out_feature_class | Entités en entrée mises à jour. | Classe d’entités |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil TrimLine.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.TrimLine_edit("majorrds.shp", "15 Feet", "DELETE_SHORT")
Nettoyez 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
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?