É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. | Field |
Champs de statistiques (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. 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 :
| 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. | String |
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
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. | 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. 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 :
| 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. | String |
Exemple de code
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"])
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
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?