ArcMap

Annuler le fractionnement d'une ligne

Résumé

Fusionne les lignes dont les extrémités sont coïncidentes ainsi que les valeurs attributaires communes (facultatif).

Illustration

Illustration de l'outil UnsplitLine

Utilisation

  • Diverses statistiques permettent de récapituler ou de décrire les attributs des entités qui sont agrégées avec cet outil. Le type de statistiques utilisé pour récapituler les attributs est ajouté à la classe d'entités en sortie sous forme de champ unique répondant à la norme d'affectation de nom suivante : type de statistiques + trait de soulignement + nom du champ en entrée. Par exemple, si l'entrée a un champ nommé POP récapitulé, si vous utilisez le type de statistiques SOMME, vous obtiendrez un champ nommé SUM_POP dans la classe d'entités en sortie.

  • 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é linéaire 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 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 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 dans le paramètre Champ(s) de fusion pour le paramètre Champ(s) de fréquence. 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.

  • 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). L'outil Total (fonction COUNT) retourne le nombre de valeurs comprises dans le calcul statistique, c'est-à-dire 2 dans cet exemple.

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

Syntaxe

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

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

Exemple de code

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

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil UnsplitLine en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
arcpy.UnsplitLine_management("streets", "C:/output/output.gdb/streets_unsplit",
                             ["STREETNAME", "PREFIX"])
2e exemple d'utilisation de l'outil UnsplitLine (script autonome)

Le script autonome ci-dessous explique comment utiliser l'outil 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"]
 
# Execute UnsplitLine using STREETNAME and PREFIX as Dissolve Fields
arcpy.UnsplitLine_management(inFeatures, outFeatureClass, dissolveFields)

Environnements

Informations de licence

  • ArcGIS Desktop Basic: Non
  • ArcGIS Desktop Standard: Non
  • ArcGIS Desktop Advanced: Oui

Rubriques connexes