Résumé
Calcule les segments de ligne qui s’intersectent et se superposent dans l’espace 3D.
Utilisation
Cet outil fonctionne par paires. Si plus de deux lignes s’intersectent, le nombre de points en sortie correspond à la combinaison mathématique des lignes qui s’intersectent. Par exemple, si trois lignes s’intersectent, il y aura trois points en sortie, un pour l’intersection de la première et de la deuxième ligne, un autre pour l’intersection de la première et de la troisième ligne, et un dernier pour l’intersection de la deuxième et de la troisième ligne. De même, si quatre lignes s’intersectent, il y aura six points en sortie : pour la première et la deuxième, la première et la troisième, la première et la quatrième, la deuxième et la troisième, la deuxième et la quatrième, et la troisième et la quatrième.
Les entités en entrée doivent avoir un index spatial. Utilisez l'outil Ajouter un index spatial pour créer un nouvel index (en particulier pour les fichiers de formes) ou pour régénérer un index existant si vous doutez de son exactitude.
Si des lignes 2D sont fournies en entrée, tous les sommets sont considérés comme situés à l’altitude zéro.
Lorsque deux lignes ayant des valeurs z différentes s’intersectent en raison de la tolérance verticale autorisée pour la détection des intersections, le point en sortie utilise la plus haute des deux altitudes. De même, lorsque deux segments de ligne ayant des valeurs z différentes s’intersectent, l’entité linéaire en sortie est basée sur les segments possédant les valeurs z les plus élevées.
Certaines lignes en sortie peuvent se composer de plusieurs parties en raison de la présence de deux lignes en entrée comportant plusieurs sections superposées discontinues ou de lignes qui se rapprochent et s’éloignent dans la direction z.
Lorsque les attributs sont transférés vers la sortie, les valeurs placées dans le premier jeu de champs proviennent de la première ligne en entrée, et celles du second jeu de champs proviennent de la seconde ligne en entrée. Si deux entités linéaires en entrée sont spécifiées, la première ligne en entrée et la seconde proviennent de la première entité linéaire en entrée et de la seconde, respectivement. Si une seule entité linéaire en entrée est spécifiée, la règle est la même, sauf que les colonnes semblent se répéter.
Les entités ponctuelles en sortie incluent les champs attributaires suivants :
- I3L_TYPE : la valeur 0 indique que le point marque le point final du segment de ligne superposé, tandis que la valeur 1 indique que le point correspond à une intersection de deux lignes.
- I3L_GROUP : valeur unique qui identifie tous les points qui partagent la même position dans l’espace horizontal.
- I3L_OID1 : ID d’entité de la première entité linéaire qui s’intersecte.
- I3L_OID2 : ID d’entité de la seconde entité linéaire qui s’intersecte.
- I3L_LINE1Z : valeur Z du point d’intersection sur la première ligne.
- I3L_LINE2Z : valeur Z du point d’intersection sur la deuxième ligne.
- I3L_Z_DIFF : différence Z entre les deux lignes en entrée à l’emplacement XY de l’intersection.
Syntaxe
arcpy.3d.Intersect3DLines(in_lines, {max_z_diff}, {join_attributes}, {out_point_fc}, {out_line_fc})
Paramètre | Explication | Type de données |
in_lines [in_lines,...] | Entités linéaires qui seront évaluées pour les intersections. L’entrée peut se composer d’une ou deux couches ou classes d’entités linéaires. Si une entrée est spécifiée, chaque entité est comparée à toutes les autres entités de la classe d’entités. Aucune entité n’est comparée à elle-même. | Feature Layer |
max_z_diff (Facultatif) | Distance verticale maximale entre des segments de ligne qui s’intersectent. | Linear Unit |
join_attributes (Facultatif) | Spécifie les attributs des entités en entrée qui sont transférés vers la classe d’entités en sortie.
| String |
out_point_fc (Facultatif) | Points en sortie qui représentent les emplacements où les lignes en entrée s’intersectent, y compris les emplacements où les segments de ligne superposés commencent et se terminent. | Feature Class |
out_line_fc (Facultatif) | Lignes en sortie qui représentent les sections superposées qui existent entre les lignes en entrée. | Feature Class |
Sortie dérivée
Nom | Explication | Type de données |
out_intersection_count | Nombre d’emplacements d’intersection sur les lignes en entrée. | Long |
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.Intersect3DLines(['floor_centerlines.shp', 'stairs.shp'], '2 Meters',
'ONLY_FID', 'intersection_pts.shp')
Environnements
Informations de licence
- Basic: Requiert 3D Analyst ou ArcGIS Location Referencing
- Standard: Requiert 3D Analyst ou ArcGIS Location Referencing
- Advanced: Requiert 3D Analyst ou ArcGIS Location Referencing
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?