Fusionner (Gestion des données)

Récapitulatif

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 suivante : 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 de sortie portera le nom suivant : "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 figurent dans les 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 d'affichage et/ou d'altérer les performances lors de leur représentation sur une carte ou de leur modification. Pour éviter ces problèmes, utilisez l'option SINGLE_PART du paramètre Créer des entités multi-parties pour fractionner les entités multi-parties susceptibles d'être très grandes en de nombreuses entités plus petites.

• Les valeurs Null sont exclues de tous les calculs statistiques. Par exemple, la valeur AVERAGE de 10, 5 et NULL est 7,5 ((10+5)/2). L'outil Total (fonction COUNT) retourne le nombre de valeurs comprises dans le calcul statistique, c'est-à-dire 2 dans cet exemple.

• 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, les entités en entrée peuvent être séparées et traitées à 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 FREQUENCE 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. Ces limites peuvent être évaluées et supprimés en procédant à une deuxième opération de fusion ou en utilisant la tâche de mise à jour de la fusion dans ArcMap (1. démarrez la mise à jour ; 2. sélectionnez les deux entités ; 3. cliquez sur Editeur\Combiner...).

• Le bouton Ajouter un champ du paramètre Champ(s) de fusion est uniquement utilisé dans ModelBuilder. Dans ModelBuilder, si l'outil précédent n'a pas été exécuté ou si ses données dérivées n'existent pas, le paramètre Champ(s) de fusion peut ne pas comporter de noms de champ. Le bouton Ajouter un champ permet d'ajouter des champs attendus pour continuer à renseigner la boîte de dialogue et poursuivre la construction du modèle.

• Le paramètre Lignes non fractionnées ne s'applique, avec les deux options DISSOLVE_LINES et UNSPLIT_LINES, qu'à la ligne en entrée. Lorsque l'option par défaut DISSOLVE_LINES est spécifiée, les lignes sont fusionnées dans une seule entité. Lorsque l'option UNSPLIT_LINES est spécifiée, seules les deux lignes qui ont une extrémité en commun (désignée par "pseudo-nœud") sont fusionnées sur une ligne continue.

• 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.

Syntaxe

Dissolve_management (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, qui n'est utilisé que dans ModelBuilder, vous permet d'ajouter les champs attendus pour continuer à renseigner la boîte de dialogue et poursuivre la construction du modèle.	Field
statistics_fields [[field, {statistic_type}],...] (Facultatif)	Champs et statistiques utilisés pour récapituler les attributs. Les champs attributaires de texte peuvent être récapitulés à l'aide des statistiques FIRST ou LAST. Les champs attributaires numériques peuvent être récapitulés à l'aide de toutes les statistiques. Les valeurs Null sont exclues de tous les calculs statistiques. FIRST - Recherche le premier enregistrement dans les entités en entrée et utilise la valeur du champ spécifié. LAST - Recherche le dernier enregistrement dans les entités en entrée et utilise la valeur du champ spécifié. 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 (MAX-MIN) 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 la statistique COUNT sur le champ en question et une statistique COUNT sur un champ différent qui ne contient pas de valeurs Null (par exemple l'identifiant OID, s'il existe), puis soustrayez les deux valeurs.	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 illustre l'utilisation de l'outil Fusionner en mode immédiat.

import arcpy
from arcpy import env
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 Fusionner.

# Name: Dissolve_Example2.py
# Description: Dissolve features based on common attributes
# Author: ESRI
 
# Import system modules
import arcpy
from arcpy import env
 
# Set environment settings
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, Etendue, 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 1, 2, 3 en sortie, Domaine XY en sortie, Domaine M en sortie, Domaine Z en sortie

Informations de licence

ArcView : Oui

ArcEditor : Oui

ArcInfo : Oui