Fusion deux par deux (Analyse)

Synthèse

Permet d'agréger des entités en fonction d'attributs spécifiés, à l'aide d'une approche de traitement parallèle.

Un outil alternatif est disponible pour les opérations de fusion. Reportez-vous à la documentation de l’outil Fusionner pour plus de détails.

Illustration

Illustration de l'outil Fusionner

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 en sortie se nommera SUM_POP.

  • Les entités très volumineuses peuvent être créées 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 entités très volumineuses risquent de poser des problèmes de traitement ou d'affichage et/ou d'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, décochez l’option Créer des entités multi-parties pour fractionner les entités multi-parties susceptibles d’être très volumineuses en de nombreuses entités plus petites. Dans le cas d’entités très volumineuses, l’outil Segmenter devra peut-être ê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 valeur AVERAGE de 10, 5 et NULL est 7,5 ((10+5)/2). La statistique COUNT renvoie le nombre de valeurs comprises dans le calcul statistique, c’est-à-dire 2.

  • The Dissolve Field(s) parameter's Add Field button is used only in ModelBuilder. In ModelBuilder, where the preceding tool has not been run, or its derived data does not exist, the Dissolve Field(s) parameter may not be populated with field names. The Add Field button allows you to add expected fields so you can complete the tool's dialog box and continue to build your model.

  • 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 activée, 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, la sortie est une classe d’entités points.

  • Par défaut, les entités de courbe de l’entrée seront densifiées dans la sortie. Pour prendre en charge les courbes dans la sortie, utilisez l’environnement Maintain Curve Segments (Conserver les segments de courbe).

  • L'outil Fusion deux par deux 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 parmi tous les cœurs logiques de la machine. Si vous définissez l'environnement sur 0, le traitement parallèle est désactivé. Si vous spécifiez un facteur compris entre 1 et 99, l'outil détermine 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

ÉtiquetteExplicationType de données
Entités en entrée

Entités à agréger.

Feature Layer
Classe d’entités en sortie

Classe d’entités à créer pour contenir les entités agrégées.

Feature Class
Champ(s) de fusion
(Facultatif)

Champ(s) utilisé(s) pour agréger les entités.

Field
Champ(s) statistique(s)
(Facultatif)

Spécifie le ou les champ(s) numérique(s) contenant les valeurs attributaires utilisées pour 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 :

  • Somme : additionne les valeurs du champ spécifié.
  • Moyenne : calcule la moyenne du champ spécifié.
  • Minimum : recherche la valeur la plus faible parmi tous les enregistrements du champ spécifié.
  • Maximum : recherche la valeur la plus élevée parmi tous les enregistrements du champ spécifié.
  • Plage : calcule la plage de valeurs (maximum moins minimum) du champ spécifié.
  • Écart type : calcule l’écart type des valeurs du champ spécifié.
  • Total : recherche le nombre de valeurs incluses dans les calculs statistiques. Toutes les valeurs sont comptées à l’exception des valeurs nulles. Pour déterminer le nombre de valeurs nulles dans un champ, utilisez COUNT sur le champ en question, puis sur un autre champ qui ne contient pas de valeurs nulles (par exemple l’OID, s’il est présent), puis soustrayez les deux valeurs.
  • Premier : utilise la valeur du champ spécifié pour le premier enregistrement en entrée.
  • Dernier : utilise la valeur du champ spécifié pour le dernier enregistrement en entrée.
  • Médiane : calcule la médiane de tous les enregistrements du champ spécifié.
  • Variance : calcule la variance de tous les enregistrements du champ spécifié.
  • Unique : calcule le nombre de valeurs uniques du champ spécifié.
Value Table
Créer des entités multi-parties
(Facultatif)

Indique si les entités multi-parties sont autorisées dans la classe d’entités en sortie.

  • Activé : les entités multi-parties sont autorisées. Il s’agit de l’option par défaut.
  • Désactivé : 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

arcpy.analysis.PairwiseDissolve(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {multi_part})
NomExplicationType 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)

Champ(s) utilisé(s) pour agréger les entités.

Field
statistics_fields
[[field, {statistic_type}],...]
(Facultatif)

Spécifie le ou les champ(s) numérique(s) contenant les valeurs attributaires utilisées pour 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 : additionne les valeurs du champ spécifié.
  • MEAN : calcule la moyenne du champ spécifié.
  • MIN : recherche la valeur la plus faible parmi tous les enregistrements du champ spécifié.
  • MAX : recherche la valeur la plus élevée parmi tous les enregistrements du champ spécifié.
  • RANGE : calcule la plage de valeurs (maximum moins minimum) du champ spécifié.
  • STD : calcule l’écart type des valeurs du champ spécifié.
  • COUNT : recherche le nombre de valeurs incluses dans les calculs statistiques. Toutes les valeurs sont comptées à l’exception des valeurs nulles. Pour déterminer le nombre de valeurs nulles dans un champ, utilisez COUNT sur le champ en question, puis sur un autre champ qui ne contient pas de valeurs nulles (par exemple l’OID, s’il est présent), puis soustrayez les deux valeurs.
  • FIRST : utilise la valeur du champ spécifié pour le premier enregistrement en entrée.
  • LAST : utilise la valeur du champ spécifié pour le dernier enregistrement en entrée.
  • MEDIAN : calcule la médiane de tous les enregistrements du champ spécifié.
  • VARIANCE : calcule la variance de tous les enregistrements du champ spécifié.
  • UNIQUE : calcule le nombre de valeurs uniques 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_PARTLes entités multi-parties sont autorisées. Il s’agit de l’option par défaut.
  • SINGLE_PARTLes 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

Exemple de code

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

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

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
arcpy.PairwiseDissolve_analysis("taxlots", "C:/output/output.gdb/taxlots_dissolved",
                                ["LANDUSE", "TAXCODE"], "", "SINGLE_PART")
Exemple 2 d'utilisation de l'outil PairwiseDissolve (script autonome)

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

# Name: PairwiseDissolve_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.PairwiseDissolve_analysis(tempLayer, outFeatureClass, dissolveFields, "", 
                                "SINGLE_PART")

Informations de licence

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

Rubriques connexes