Intersection deux par deux (Analyse)

Synthèse

Calcule une intersection deux par deux des entités en entrée. Les entités ou les portions des entités superposées entre les couches d’entités en entrée ou classes d’entités sont écrites dans la classe d’entités en sortie. L’intersection deux par deux désigne la sélection d’une entité dans la première entrée, puis son intersection avec les entités de la seconde entrée auxquelles elle est superposée.

Un outil alternatif est disponible pour les opérations d’intersection. Pour plus de détails, reportez-vous à la documentation de l’outil Intersecter.

L’outil Intersection deux par deux est semblable à l’outil Intersection dans le sens où les intersections géométriques sont calculées, mais il est différent dans le sens où les intersections sont calculées sur des paires d’entités et non sur toutes les combinaisons d’entités.

Pour en savoir plus sur le fonctionnement de l'outil Intersection deux par deux

Illustration

Illustration de l’outil Intersection deux par deux

Utilisation

  • Seules deux classes d'entités en entrée sont prises en charge.

  • L’entrée doit être des entités simples, de type point, multi-points, ligne ou polygone. Vous ne pouvez pas utiliser d’entités complexes telles que les entités annotation, les entités cotation ou les entités de réseau.

  • Si les entrées présentent des types de géométrie différents, le type de géométrie en sortie correspond par défaut à la dimension la plus petite des entrées.

    • Si une entrée est constituée d’entités ponctuelles, la sortie par défaut est constituée d’entités ponctuelles.
    • Si une entrée est constituée d’entités linéaires et qu’il n’y a aucune entrée avec des entités ponctuelles, la sortie par défaut est constituée d’entités linéaires.
    • Si toutes les entrées sont des entités surfaciques, la sortie par défaut est constituée d’entités surfaciques.

  • La valeur du paramètre Type en sortie peut être celle du paramètre Entités en entrée ayant la géométrie de dimension la plus faible, ou inférieure. Par exemple, si toutes les entrées sont des polygones, la sortie peut être de type polygone, ligne ou point. Si l’une des entrées est de type ligne et qu’aucune n’est de type point, les données en sortie peuvent être de type ligne ou point. Si au moins une des entrées est de type point, la valeur Output Type (Type en sortie) peut uniquement être point.

  • Le paramètre Utiliser la précision maximale s’applique uniquement lorsque la valeur du paramètre Type en sortie est Point. La précision est une combinaison de la résolution x,y et de la tolérance x,y qui est utilisée au cours du traitement. Par défaut, les propriétés de la référence spatiale de la première classe d’entités Entités en entrée sont utilisées.

    Lorsque le paramètre Précision est sélectionné, la valeur de précision maximale autorisée sera utilisée pour la sortie de point. L’outil utilise la précision maximale dont il dispose, qui dépend de la valeur absolue des coordonnées géométriques et de la précision de la virgule flottante matérielle. La tolérance maximale qui sera utilisée est estimée approximativement à 0,002 millimètre, comparativement à la valeur par défaut de 1 millimètre.

    Lors de l’écriture de la sortie, la résolution de la référence spatiale sera appliquée si bien qu’il peut y avoir un léger décalage des points.

    Lorsque les données en entrée contiennent des segments non linéaires (courbes), pour de meilleurs résultats, activez l’environnement Conserver les segments de courbe et définissez l’environnement Méthode de traitement des courbes sur EXACT.

  • Contrairement à l'outil Intersection, les classements ne sont pas pris en charge.

  • Par défaut, les entités de courbe de l’entrée seront densifiées dans la sortie. Pour prendre en charge les courbes dans la sortie, utilisez l’environnement Conserver les segments de courbe.

  • Toutes les entrées doivent comporter un index spatial. Utilisez l’outil Ajouter un index spatial pour créer un index (en particulier pour les shapefiles) ou pour recréer un index spatial existant si vous pensez qu’il peut être incorrect.

  • Lorsque les entités en entrée possèdent des valeurs m ou z, seules les valeurs m ou z de la première classe d’entités seront transférées vers les entités en sortie. Si la première classe d’entités ne contient pas de valeurs m ou z, la sortie ne comportera ni valeurs m, ni valeurs z.

  • La référence spatiale de la classe d’entités en sortie demeure celle de la première classe d’entités dans le paramètre Entités en entrée. Pour plus d’informations, consultez Référence spatiale et géotraitement.

  • Cet outil respecte l’environnement Facteur de traitement parallèle. Si l’environnement n’est pas défini (valeur par défaut) ou s’il est défini sur 100, le traitement parallèle complet est activé et l’outil tente de répartir les tâches sur tous les cœurs logiques de la machine. Si l’environnement est défini sur 0, le traitement parallèle n’est pas activé. Si vous spécifiez un facteur compris entre 1 et 99, l’outil identifie le pourcentage de cœurs logiques à utiliser en appliquant la formule (Facteur de traitement parallèle / 100 * Cœurs logiques) arrondie à l’entier supérieur le plus proche. Si le résultat de cette formule est 0 ou 1, le traitement parallèle n’est pas activé.

Paramètres

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

Couches ou classes d’entités en entrée qui seront intersectées. Seulement deux entrées sont prises en charge.

Value Table
Classe d’entités en sortie

Classe d’entités en sortie.

Feature Class
Attributs de jointure
(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 du champ FID sont transférés dans la classe d'entités en sortie.
  • Identifiants d'entités uniquementSeul le champ FID des entités en entrée est transféré vers la classe d'entités en sortie.
String
Tolérance XY
(Facultatif)

Distance minimale séparant toutes les coordonnées d’entités (nœuds et sommets), ainsi que la distance de déplacement possible d’une coordonnée sur l’axe X ou Y (ou les deux).

Attention :

Modifier la valeur de ce paramètre peut provoquer des erreurs ou des résultats inattendus. Il est recommandé de ne pas modifier ce paramètre. Ce paramètre n’est plus affiché dans la boîte de dialogue de l’outil. Par défaut, la propriété Tolérance x,y de la référence spatiale de la classe d’entités en entrée est utilisée.

Linear Unit
Type en sortie
(Facultatif)

Spécifie le type d’intersection à renvoyer.

  • Identique à l’entréeLes intersections retournées présentent le même type de géométrie que les entités en entrée ayant la géométrie de cote la plus basse. Si toutes les entrées sont de type polygone, la classe d’entités en sortie contient des polygones. Si une ou plusieurs données en entrée sont de type ligne et qu'aucune n'est de type point, les données en sortie sont des lignes. Si une ou plusieurs des données en entrée sont de type point, la classe d’entités en sortie contient des points. Il s’agit de l’option par défaut.
  • LigneLes intersections renvoyées sont de type ligne. Option valide uniquement si aucune entrée n’est de type point.
  • PointLes intersections renvoyées sont de type point. Si les entrées sont de type ligne ou polygone, la sortie est une classe d’entités multi-points.
String
Utiliser la précision maximale
(Facultatif)

Spécifie le niveau de précision qui sera utilisé lorsque la valeur du paramètre Type en sortie est Point. Ce paramètre n’est pas pris en charge lorsque la valeur du paramètre Type en sortie est Identique à l’entrée ou Ligne. Activez ce paramètre lorsque vous voulez que l’outil applique un niveau de précision supérieur à la valeur par défaut pour la référence spatiale en entrée lors de la détermination de la sortie de point.

  • Activé : la précision maximale sera utilisée pour déterminer la sortie de point.
  • Désactivé : la précision de la première classe d’entités en entrée sera utilisée pour déterminer la sortie de point. Il s’agit de l’option par défaut.
Boolean

arcpy.analysis.PairwiseIntersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type}, {precision})
NomExplicationType de données
in_features
[in_features,...]

Couches ou classes d’entités en entrée qui seront intersectées. Seulement deux entrées sont prises en charge.

Value Table
out_feature_class

Classe d’entités en sortie.

Feature Class
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 du champ FID sont transférés dans la classe d'entités en sortie.
  • ONLY_FIDSeul le champ FID des entités en entrée est transféré vers la classe d'entités en sortie.
String
cluster_tolerance
(Facultatif)

Distance minimale séparant toutes les coordonnées d’entités (nœuds et sommets), ainsi que la distance de déplacement possible d’une coordonnée sur l’axe X ou Y (ou les deux).

Attention :

Modifier la valeur de ce paramètre peut provoquer des erreurs ou des résultats inattendus. Il est recommandé de ne pas modifier ce paramètre. Ce paramètre n’est plus affiché dans la boîte de dialogue de l’outil. Par défaut, la propriété Tolérance x,y de la référence spatiale de la classe d’entités en entrée est utilisée.

Linear Unit
output_type
(Facultatif)

Spécifie le type d’intersection à renvoyer.

  • INPUTLes intersections retournées présentent le même type de géométrie que les entités en entrée ayant la géométrie de cote la plus basse. Si toutes les entrées sont de type polygone, la classe d’entités en sortie contient des polygones. Si une ou plusieurs données en entrée sont de type ligne et qu'aucune n'est de type point, les données en sortie sont des lignes. Si une ou plusieurs des données en entrée sont de type point, la classe d’entités en sortie contient des points. Il s’agit de l’option par défaut.
  • LINELes intersections renvoyées sont de type ligne. Option valide uniquement si aucune entrée n’est de type point.
  • POINTLes intersections renvoyées sont de type point. Si les entrées sont de type ligne ou polygone, la sortie est une classe d’entités multi-points.
String
precision
(Facultatif)

Spécifie le niveau de précision qui sera utilisé lorsque la valeur du paramètre output_type est POINT. Ce paramètre n’est pas pris en charge lorsque la valeur du paramètre output_type est INPUT ou LINE. Utilisez l’option MAX_PRECISION lorsque vous voulez que l’outil applique un niveau de précision supérieur à la valeur par défaut pour la référence spatiale en entrée lors de la détermination de la sortie de point.

  • MAX_PRECISIONLa précision maximale sera utilisée pour déterminer la sortie de point.
  • DEFAULT_PRECISIONLa précision de la première classe d’entités en entrée sera utilisée pour déterminer la sortie de point. Il s’agit de l’option par défaut.
Boolean

Exemple de code

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

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction PairwiseIntersect en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
arcpy.analysis.PairwiseIntersect(["vegetation_stands", "road_buffer200m", "water_buffer100"], 
                                 "mysites", "ALL")
Exemple 2 d'utilisation de la fonction PairwiseIntersect (script autonome)

Identification du type de végétation traversé par les rivières.

# Name: StreamsInVegetationIntersect.py
# Purpose: Determine the vegetation type streams are traveling through.

# Import system modules
import arcpy

# Set the workspace (to avoid having to type the full path to the data every time)
arcpy.env.workspace = "c:/data/data.gdb"    

# Process: Find all streams in each vegetation type
inFeatures = ["vegetation", "streams"]
intersectOutput = "streams_in_vegtype"

arcpy.analysis.PairwiseIntersect(inFeatures, intersectOutput)

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes