Résumé
L'outil Intégrer est utilisé pour conserver l'intégrité des limites d'entité partagées en rendant les entités coïncidentes si elles sont comprises dans la tolérance x,y indiquée. Les entités comprises dans la tolérance x,y indiquée sont considérées identiques ou coïncidentes.
Par exemple, supposez que vous spécifiez une tolérance x,y de cinq unités (pieds ou mètres) et que vos données ont une limite de parcelle qui doit être partagée avec la limite de parcelle adjacente, mais se trouve à quatre unités de là. Après avoir exécuté cet outil, les limites des deux parcelles seront rendues coïncidentes car elles sont comprises dans la tolérance x,y de cinq unités.
L'outil Intégrer exécute les tâches de traitement suivantes :
- Il recherche les entités comprises dans la tolérance x,y.
- Il insère des sommets de coordonnée communs pour les entités comprises dans la tolérance x,y donnée et ajoute des sommets aux intersections des segments.
Illustration
Utilisation
S'il existe des entités en entrée 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 en rapport les unes avec les autres. Pour plus d'informations sur l'utilisation des topologies, reportez-vous à Principes de base d'une topologie.
Il est conseillé d'utiliser l'outil Intégrer plutôt qu'une topologie lorsque :
- Vous n'avez pas besoin de spécifier de règle sur le déplacement des entités ; vous souhaitez simplement 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 de non-géodatabase telles que des fichiers de formes, ou avec des entités de géodatabases différentes (dans une topologie, les entités doivent toutes provenir du même jeu de données d'entité).
La valeur de la Tolérance XY est crucial : une tolérance trop large risque de réduire et de supprimer des polygones ou des lignes, ou de déplacer des sommets qui ne doivent pas l'être. Pour minimiser le risque d'erreur, attribuez la plus petite valeur possible à la tolérance x,y de comparaison.
L'outil Intégrer accepte uniquement des classes d'entités simples comme entrées (points, multi-points, lignes ou polygones). Les entités en entrée ne peuvent pas comprendre d'entités annotations, d'entités cotations, d'entités de réseau, etc.
Pour annuler des modifications apportés aux entités en entrée, utilisez l'outil Intégrer dans une session de mise à jour.
Lors du traitement de jeux de données qui contiennent des entités individuelles avec un nombre très grand de sommets (par exemple, de centaines de milliers à plusieurs millions de sommets dans une seule entité), certaines opérations de traitement géométriques peuvent épuiser vos capacités de mémoire. Pour plus de détails, reportez-vous à la rubrique Géotraitement sur jeux de données volumineux.
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.
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.
Syntaxe
Integrate_management (in_features, {cluster_tolerance})| Paramètre | Explication | Type de données |
in_features [[Feature Layer, Long],...] | Classe d'entités à intégrer. 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). La couche ou la classe d'entités de rang inférieur s'aligne alors sur l'entité de la couche ou de la classe d'entités de rang plus élevé (1 étant un rang plus élevé que 2). Notez que les entités dans la classe d'entités de rang 1 peuvent être déplacée lorsqu'une tolérance x,y large est utilisée. | 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 relativement faible. Si aucune valeur n'est spécifiée, la tolérance x,y du premier jeu de données dans la liste des entrées est utilisée. | Linear unit |
Exemple de code
Exemple d'utilisation de l'outil Intégrer (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction Intégrer en mode immédiat.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.CopyFeatures_management("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.Integrate_management("C:/output/output.gdb/vegtype", 0.01)
Exemple 2 d'utilisation de l'outil Intégrer (script autonome)
Le script autonome suivant dessous est un exemple d'application simple de la fonction Intégrer dans un environnement de scripts.
# Name: Integrate_Example2.py
# Description: Run Integrate on a feature class
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data/Habitat_Analysis.gdb"
# Set local variables
inFeatures = "vegtype"
integrateFeatures = "C:/output/output.gdb/vegtype"
xyTolerance = "0.1 feet"
# Execute CopyFeature (since Integrate modifies the original data
# this ensures the original is preserved)
arcpy.CopyFeatures_management(inFeatures, integrateFeatures)
# Execute Integrate
arcpy.Integrate_management(integrateFeatures, xyTolerance)
Environnements
Informations de licence
- ArcGIS Desktop Basic: Oui
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui