Fusionner (Gestion des données)

Niveau de licence :BasicStandardAdvanced

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

Illustration de la fonction Fusionner
Illustration de la fonction Fusionner

Utilisation

Syntaxe

Dissolve_management (in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {multi_part}, {unsplit_lines})
ParamètreExplicationType 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 des 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)

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 nulles 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 nulles (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_PARTIndique que les entités multi-parties sont autorisées. Il s'agit de l'option par défaut.
  • SINGLE_PARTIndique 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_LINESLes lignes sont fusionnés dans une seule entité. Il s'agit de l'option par défaut.
  • UNSPLIT_LINESLes 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

 
# 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

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Oui
ArcGIS for Desktop Standard: Oui
ArcGIS for Desktop Advanced: Oui
6/5/2014