Intersecter des lignes 3D (3D Analyst)

Synthèse

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.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

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
Différence Z maximale
(Facultatif)

Distance verticale maximale entre des segments de ligne qui s’intersectent.

Linear Unit
Attributs à joindre
(Facultatif)

Spécifie les attributs des entités en entrée qui sont transférés vers la classe d’entités en sortie.

  • Tous les attributsTous les attributs provenant des entités en entrée sont transférés vers la classe d’entités en sortie. Il s’agit de l’option par défaut.
  • Tous les attributs à l’exception des identifiants d’entitésTous les attributs issus des entités en entrée à l’exception de l’attribut FID sont transférés dans la classe d’entités en sortie.
  • Identifiants d’entités uniquementSeul l’attribut FID des entités en entrée est transféré vers la classe d’entités en sortie.
String
Classe d'entités points en sortie
(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
Classe d’entités linéaires en sortie
(Facultatif)

Lignes en sortie qui représentent les sections superposées qui existent entre les lignes en entrée.

Feature Class

Sortie obtenue

ÉtiquetteExplicationType de données
Nombre d’intersections en sortie

Nombre d’emplacements d’intersection sur les lignes en entrée.

Long

arcpy.ddd.Intersect3DLines(in_lines, {max_z_diff}, {join_attributes}, {out_point_fc}, {out_line_fc})
NomExplicationType 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.

  • ALLTous les attributs provenant des entités en entrée sont transférés vers la classe d’entités en sortie. Il s’agit de l’option par défaut.
  • NO_FIDTous les attributs issus des entités en entrée à l’exception de l’attribut FID sont transférés dans la classe d’entités en sortie.
  • ONLY_FIDSeul l’attribut FID des entités en entrée est transféré 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 obtenue

NomExplicationType de données
out_intersection_count

Nombre d’emplacements d’intersection sur les lignes en entrée.

Long

Exemple de code

Exemple d’utilisation de l’outil Intersect3DLines (fenêtre Python)

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')

Rubriques connexes