Fusionner des lignes (Gestion des données)

Synthèse

Permet d’agréger les entités linéaires dont les extrémités sont coïncidentes, ainsi que les valeurs attributaires communes (facultatif).

Illustration

Utilisation

• Diverses statistiques permettent de récapituler ou de décrire les attributs des entités qui sont agrégées avec cet outil. 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 noms : type de statistique + trait de soulignement + nom du champ en entrée. Par exemple, si le type de statistique SUM est appliqué à un champ nommé POP, la sortie inclut un champ nommé SUM_POP.

• En fonction de la mémoire physique disponible, les entités en entrée pouvant être traitées et agrégées dans une seule entité linéaire en sortie risquent d’être limitées en nombre (et en complexité). Cette limitation peut provoquer une erreur, car le processus de fusion peut exiger davantage de mémoire que celle disponible. Pour éviter ce problème, Fusionner des lignes peut diviser et traiter les entités en entrée à l'aide d'un algorithme de tuilage adaptatif. Pour déterminer les entités ayant fait 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 dans le paramètre Champ(s) de fusion pour le paramètre Champ(s) de fréquence. Tout enregistrement présentant une valeur de fréquence de 2 a fait l’objet d’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 volumineuses pour être utilisées dans ArcGIS.

  Attention :

  L’exécution de l’outil Annuler le fractionnement d’une ligne sur la sortie d’un précédent processus de fusion 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. La présence de tuiles dans la sortie indique qu’agréger 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 Annuler le fractionnement d’une ligne 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.

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

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Entités linéaires à 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
Champs de fusion (Facultatif)	Champ(s) utilisé(s) pour agréger les entités. Si aucun champ n’est spécifié, l’outil fusionne toutes les entités.	Field
Champs de statistiques (Facultatif)	Spécifie le ou les champs 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. Par défaut, l’outil ne calcule aucune statistique. 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 : la valeur la plus faible parmi tous les enregistrements du champ spécifié est identifiée. Maximum : la valeur la plus élevée parmi tous les enregistrements du champ spécifié est identifiée. 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. 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é. Concaténer : les valeurs du champ spécifié seront concaténées. Les valeurs peuvent être séparées à l’aide du paramètre Séparateur de concaténation.	Value Table
Séparateur de concaténation (Facultatif)	Un ou plusieurs caractères utilisés pour concaténer des valeurs lorsque l’option Concaténation est utilisée pour le paramètre Champs de statistiques. Par défaut, l’outil concatène les valeurs sans séparateur.	String

Python

arcpy.management.UnsplitLine(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {concatenation_separator})

Nom	Explication	Type de données
in_features	Entités linéaires à 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. Si aucun champ n’est spécifié, l’outil fusionne toutes les entités.	Field
statistics_fields [[field, {statistic_type}],...] (Facultatif)	Spécifie le ou les champs 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. Par défaut, l’outil ne calcule aucune statistique. 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 : la valeur la plus faible parmi tous les enregistrements du champ spécifié est identifiée. MAX : la valeur la plus élevée parmi tous les enregistrements du champ spécifié est identifiée. 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. 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é. CONCATENATE : les valeurs du champ spécifié seront concaténées. Les valeurs peuvent être séparées à l’aide du paramètre concatenation_separator.	Value Table
concatenation_separator (Facultatif)	Un ou plusieurs caractères utilisés pour concaténer des valeurs lorsque l’option CONCATENATION est utilisée pour le paramètre statistics_fields. Par défaut, l’outil concatène les valeurs sans séparateur.	String

Exemple de code

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

La fenêtre de script Python suivante illustre l’utilisation de la fonction UnsplitLine en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
arcpy.management.UnsplitLine("streets", "C:/output/output.gdb/streets_unsplit",
                             ["STREETNAME", "PREFIX"])

2e exemple d'utilisation de l'outil UnsplitLine (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction UnsplitLine.

# Name: UnsplitLine_Example2.py
# Description: Unsplit line features based on common attributes
 
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
 
# Set local variables
inFeatures = "streets"
outFeatureClass = "C:/output/output.gdb/streets_unsplit"
dissolveFields = ["STREETNAME", "PREFIX"]
 
# Run UnsplitLine using STREETNAME and PREFIX as Dissolve Fields
arcpy.management.UnsplitLine(inFeatures, outFeatureClass, dissolveFields)

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, Domaine XY en sortie, Domaine M en sortie, Domaine Z en sortie