Fusionner

Résumé

Agrège des entités en fonction des attributs spécifiés.

Pour en savoir plus sur le fonctionnement de l'outil Fusionner

Illustration

Utilisation

• Diverses statistiques permettent de récapituler ou de décrire les attributs des entités qui sont agrégées avec l'outil Fusionner. La statistique utilisée pour récapituler les attributs est ajoutée à la classe d'entités en sortie sous forme de champ unique répondant à la norme d'attribution de nom : type de statistique + trait de soulignement + nom du champ en entrée. Par exemple, si la statistique SUM est appliquée à un champ nommé POP, le champ en sortie se nommera SUM_POP.

• L'outil Fusionner permet de créer de très grandes entités dans la classe d'entités en sortie. Tel est notamment le cas lorsqu’un petit nombre de valeurs uniques figure dans le paramètre Dissolve Field(s) (Champ[s] de fusion) ou lors de la fusion de toutes les entités dans une seule entité. Les très grandes entités risquent de poser des problèmes de traitement ou d’affichage. Elles peuvent altérer les performances lors de leur représentation sur une carte ou de leur modification. Les problèmes peuvent survenir également si la sortie de la fusion a créé une entité à la taille maximale sur un ordinateur, puis que cette sortie a été déplacée vers un ordinateur doté de moins de mémoire disponible. Pour éviter ces problèmes, utilisez le paramètre Créer des entités multi-parties pour créer des entités en une seule partie et fractionner les entités multi-parties susceptibles d'être très grandes en de nombreuses entités plus petites. Dans le cas d’entités très volumineuses créées par l’outil Fusion, l’outil Émincer peut être utilisé pour les fractionner, afin d’éviter des problèmes liés au traitement, à l’affichage ou aux performances.

• Les valeurs nulles sont exclues de tous les calculs statistiques. Par exemple, la moyenne de 10, 5 et d'une valeur Null est 7,5 ((10 + 5) / 2). Le total renvoie le nombre de valeurs comprises dans le calcul statistique, c'est-à-dire 2.

• Cet outil utilise un processus de tuilage pour la gestion des jeux de données très volumineux afin d'améliorer les performances et l'évolutivité. Pour plus de détails, reportez-vous à la rubrique Géotraitement sur jeux de données volumineux.

• En fonction de la mémoire physique disponible, les entités en entrée pouvant être traitées et fusionnées dans une seule entité en sortie risquent d'être limitées en nombre (et en complexité). Cette limitation risque de provoquer une erreur, car le processus de fusion peut exiger davantage de mémoire que celle disponible. Pour éviter ce problème, Fusionner peut diviser et traiter les entités en entrée à l'aide d'un algorithme de tuilage adaptatif. Pour déterminer les entités devant faire l'objet d'un tuilage, exécutez l'outil Fréquence sur le résultat de cet outil, en spécifiant les mêmes champs que ceux utilisés pour le paramètre Champ(s) de fréquence lors du processus de fusion. Tout enregistrement indiquant une valeur de fréquence de 2 indique un tuilage. Les limites du tuilage sont conservées dans les entités en sortie pour empêcher la création d'entités trop grandes pour être utilisées dans ArcGIS.

  Attention :

  L'exécution de l'outil Fusionner sur la sortie d'une fusion précédente réduit rarement le nombre d'entités dans la sortie lorsque le traitement initial a divisé et traité les entrées à l'aide du tuilage flexible. La taille maximale de toute entité en sortie est déterminée par la quantité de mémoire disponible au moment de l'exécution. Par conséquent, la sortie qui contient des tuiles est un indicateur que le fait de fusionner davantage avec les ressources disponibles entraînerait un manque de mémoire ou rendrait l'entité inutilisable. En outre, l’exécution de l’outil Fusionner une deuxième fois sur la sortie créée de cette façon peut ralentir considérablement les performances sans pour autant rapporter de bénéfices, et peut entraîner une défaillance inattendue.

• Le paramètre Lignes non fractionnées s'applique uniquement à l'entrée de ligne. Lorsque la valeur par défaut est spécifiée, les lignes sont fusionnées en une seule entité. Sinon, seules les deux lignes qui ont une extrémité en commun (désignée par le terme de pseudo-nœud) sont fusionnées en une ligne continue.

• Si le type de géométrie des entités en entrée est point ou multi-points et que l'option Créer des entités multi-parties est sélectionnée (MULTI_PART dans Python), la sortie est une classe d'entités multi-points. Sinon, si l'option Créer des entités multi-parties n'est pas sélectionnée (SINGLE_PART dans Python), la sortie est une classe d'entités points.

Syntaxe

arcpy.management.Dissolve(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {multi_part}, {unsplit_lines})

Paramètre	Explication	Type de données
in_features	Entités à agréger.	Feature Layer
out_feature_class	Classe d'entités à créer pour contenir les entités agrégées.	Feature Class
dissolve_field [dissolve_field,...] (Facultatif)	Champs utilisés pour agréger les entités. Le bouton Ajouter un champ, utilisé uniquement dans ModelBuilder, permet d'ajouter les champs prévus pour terminer la saisie dans la boîte de dialogue et continuer la création du modèle.	Field
statistics_fields [[field, {statistic_type}],...] (Facultatif)	Spécifie le champ numérique contenant les valeurs attributaires permettant de calculer les statistiques indiquées. Vous pouvez spécifier plusieurs combinaisons de statistiques et de champs. Les valeurs nulles sont exclues de tous les calculs statistiques. Les champs attributaires textuels peuvent être récapitulés à l’aide de la première et de la dernière statistique. Les champs attributaires numériques peuvent être récapitulés à l’aide de toutes les statistiques. Types de statistiques disponibles : SUM : ajoute la valeur totale du champ spécifié. MEAN : calcule la moyenne du champ spécifié. MIN - Recherche la plus petite valeur parmi tous les enregistrements du champ spécifié. MAX : recherche la plus grande valeur parmi tous les enregistrements du champ spécifié. RANGE : Recherche la plage de valeurs (maximum moins minimum) du champ spécifié. STD : recherche l'écart type sur les valeurs du champ spécifié. COUNT : recherche le nombre de valeurs incluses dans les calculs statistiques. Toutes les valeurs sont prises en compte, hormis les valeurs Null. Pour déterminer le nombre de valeurs Null dans un champ, utilisez COUNT sur le champ en question, puis sur un autre champ qui ne contient pas de valeurs Null (par exemple l’OID, s’il est présent), puis soustrayez les deux valeurs. FIRST : recherche le premier enregistrement en entrée et utilise la valeur du champ spécifié. LAST : recherche le dernier enregistrement en entrée et utilise la valeur du champ spécifié.	Value Table
multi_part (Facultatif)	Indique si les entités multi-parties sont autorisées dans la classe d'entités en sortie. MULTI_PART —Indique que les entités multi-parties sont autorisées. Il s’agit de l’option par défaut. SINGLE_PART —Indique que les entités multi-parties ne sont pas autorisées. Au lieu de créer des entités multi-parties, une entité individuelle est créée pour chaque partie.	Boolean
unsplit_lines (Facultatif)	Contrôle le mode de fusion des entités linéaires. DISSOLVE_LINES —Les lignes sont fusionnés dans une seule entité. Il s’agit de l’option par défaut. UNSPLIT_LINES —Les lignes sont fusionnées uniquement lorsque deux lignes ont un sommet de fin en commun.	Boolean

Exemple de code

Exemple 1 d'utilisation de l'outil Fusionner (fenêtre Python)

Le script de fenêtre Python suivant montre comment utiliser l'outil Dissolve en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
arcpy.Dissolve_management("taxlots", "C:/output/output.gdb/taxlots_dissolved",
                          ["LANDUSE", "TAXCODE"], "", "SINGLE_PART", 
                          "DISSOLVE_LINES")

Exemple 2 d'utilisation de l'outil Fusionner (script autonome)

Le script autonome suivant illustre l'utilisation de l'outil Dissolve.

# Name: Dissolve_Example2.py
# Description: Dissolve features based on common attributes
 
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
 
# Set local variables
inFeatures = "taxlots"
tempLayer = "taxlotsLyr"
expression = arcpy.AddFieldDelimiters(inFeatures, "LANDUSE") + " <> ''"
outFeatureClass = "C:/output/output.gdb/taxlots_dissolved"
dissolveFields = ["LANDUSE", "TAXCODE"]
 
# Execute MakeFeatureLayer and SelectLayerByAttribute.  This is only to exclude 
# features that are not desired in the output.
arcpy.MakeFeatureLayer_management(inFeatures, tempLayer)
arcpy.SelectLayerByAttribute_management(tempLayer, "NEW_SELECTION", expression)
 
# Execute Dissolve using LANDUSE and TAXCODE as Dissolve Fields
arcpy.Dissolve_management(tempLayer, outFeatureClass, dissolveFields, "", 
                          "SINGLE_PART", "DISSOLVE_LINES")

Environnements

• Espace de travail courant
• Espace de travail temporaire
• Système de coordonnées en sortie
• Transformations géographiques
• Étendue
• Résolution XY
• Tolérance XY
• Valeurs M en sortie
• Résolution M
• Tolérance M
• Valeurs Z en sortie
• Valeur Z en sortie par défaut
• Résolution Z
• Tolérance Z
• Noms de champ qualifiés
• Mot-clé CONFIG en sortie
• Validation automatique
• Grille spatiale 1 en sortie
• Grille spatiale 2 en sortie
• Grille spatiale 3 en sortie
• Domaine XY en sortie
• Domaine M en sortie
• Domaine Z en sortie

Informations de licence

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