Intégration deux par deux (Analyse)

Synthèse

Analyse les emplacements des coordonnées des sommets d’entités parmi les entités d’une ou de plusieurs classes d’entités. Celles situées à une distance inférieure à la distance spécifiée par rapport aux autres sont supposées représenter le même emplacement et une valeur de coordonnées commune leur est attribuée (autrement dit, elles sont capturées). L’outil ajoute également des sommets aux sommets d’entités compris dans la tolérance x,y d’un tronçon et aux intersections de segments de ligne.

L’outil Intégration deux par deux exécute les tâches de traitement suivantes :

• Le même emplacement de coordonnées est attribué aux sommets compris dans leur tolérance x,y mutuelle.
• Lorsqu’un sommet d’une entité est compris dans la tolérance x,y d’un tronçon d’une autre entité, un nouveau sommet est inséré sur le tronçon.
• En cas d’intersection des segments de ligne, un sommet est inséré au point d’intersection pour chaque entité faisant partie de l’intersection.

Un outil alternatif est disponible pour l’intégration des données vectorielles. Consultez la documentation de l’outil Intégration pour en savoir plus.

Illustration

Utilisation

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.

• Si des entités en entrée sont sélectionnées, cet outil s’exécute uniquement sur ces entités.

• Cet outil effectue le même genre de travail qu'une topologie dans la mesure où il déplace des entités comprises dans une tolérance x,y et insère des sommets aux intersections des entités. Pensez à utiliser plutôt une topologie pour effectuer ce type d’opération car elle vous permet de spécifier des règles et des conditions relatives à la façon dont les entités sont liées les unes aux autres.

  Utilisez cet outil plutôt qu’une topologie dans les cas suivants :

  • Vous n’avez pas besoin de spécifier de règle sur le déplacement des entités et vous souhaitez que toutes les entités fusionnent dans une tolérance donnée.
  • Vous souhaitez que les lignes aient des sommets partout où elles s'intersectent.
  • Vous travaillez avec des entités autres que des entités de géodatabase, par exemple des fichiers de formes, ou bien avec des entités issues de géodatabases différentes (dans une topologie, les entités doivent toutes provenir du même jeu de classes d'entités).

• Des problèmes potentiels présents dans les données peuvent être résolus au cours de l’intégration. La manipulation de très petits dépassements ou sous-dépassements, la suppression automatique des micropolygones des segments dupliqués et l’affinage de coordonnées le long des lignes de limite peuvent être résolus.

• Il est conseillé de ne pas fournir de valeur pour le paramètre Tolérance XY. Lorsqu’aucune valeur n’est fournie, l’outil vérifie la référence spatiale des classes d’entités en entrée pour déterminer la tolérance x,y à utiliser au cours de l’intégration. Vérifiez que la référence spatiale des données en entrée est définie sur sa résolution x,y par défaut et sa tolérance x,y par défaut.

  Le paramètre Tolérance XY n’est pas conçu pour généraliser les formes géométriques. Il est destiné à intégrer un dessin au trait et des limites dans le contexte d’une référence spatiale d’une classe d’entités en entrée correctement définie. Si, pour le paramètre Tolérance XY, vous définissez une autre valeur que la valeur par défaut pour la référence spatiale en entrée, il se peut que les entités se déplacent trop ou pas assez, ce qui entraînerait des problèmes de géométrie. Si les propriétés correctes de la référence spatiale sont utilisées, l’exécution de l’outil Intégrer peut réduire les déplacements des données au cours d’opérations topologiques successives (par exemple, superposition et fusion).

  En savoir plus sur le traitement des agrégats

• Cet outil accepte uniquement des classes d’entités simples comme entrées (points, multi-points, lignes ou polygones).

• Pour annuler des modifications apportées aux entités en entrée, utilisez cet outil dans une session de mise à jour.

• L'élément de données en sortie de cet outil est une sortie à valeurs multiples dérivée. Pour utiliser la ou les sorties de cet outil avec un autre outil, utilisez directement son ou ses entrées et définissez sa sortie comme précondition de l’autre outil.

  En savoir plus sur la définition d’une pré-condition

• 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

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Classes d’entités qui seront intégrées. Quand la distance entre les entités est petite comparée à la tolérance, les sommets ou les points sont regroupés (déplacés afin de coïncider).	Value Table
Tolérance XY (Facultatif)	Distance qui détermine la plage dans laquelle les sommets d'entités peuvent coïncider. Pour réduire tout mouvement indésirable de sommets, la tolérance x,y doit être faible. Si aucune valeur n’est fournie, la tolérance x,y du premier jeu de données dans la liste des entrées est utilisée. 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

Sortie obtenue

Étiquette	Explication	Type de données
Entités en entrée mises à jour	Entités en entrée mises à jour.	Feature Layer

Python

arcpy.analysis.PairwiseIntegrate(in_features, {cluster_tolerance})

Nom	Explication	Type de données
in_features [in_features,...]	Classes d’entités qui seront intégrées. Quand la distance entre les entités est petite comparée à la tolérance, les sommets ou les points sont regroupés (déplacés afin de coïncider).	Value Table
cluster_tolerance (Facultatif)	Distance qui détermine la plage dans laquelle les sommets d'entités peuvent coïncider. Pour réduire tout mouvement indésirable de sommets, la tolérance x,y doit être faible. Si aucune valeur n’est fournie, la tolérance x,y du premier jeu de données dans la liste des entrées est utilisée. 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

Sortie obtenue

Nom	Explication	Type de données
out_features	Entités en entrée mises à jour.	Feature Layer

Exemple de code

Exemple 1 d’utilisation de l’outil Intégration deux par deux (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction PairwiseIntegrate en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.CopyFeatures("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.analysis.PairwiseIntegrate("C:/output/output.gdb/vegtype")

Exemple 2 d’utilisation de l’outil Intégration deux par deux (script autonome)

Le script autonome suivant est un exemple d’application de la fonction PairwiseIntegrate dans un environnement de scripts.

# Description: Run PairwiseIntegrate on a feature class

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"

# Set local variables
inFeatures = "vegtype"
integrateFeatures = "C:/output/output.gdb/vegtype"

# Run CopyFeatures (since PairwiseIntegrate modifies the original data, this 
# ensures the original is preserved)
arcpy.management.CopyFeatures(inFeatures, integrateFeatures)

# Run PairwiseIntegrate
arcpy.analysis.PairwiseIntegrate(integrateFeatures)

Environnements

Espace de travail courant, Étendue, Tolérance XY, Facteur de traitement parallèle

Informations de licence

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