Fusionner les limites (GeoAnalytics Desktop)

Résumé

Recherche des polygones qui s’intersectent ou ont les mêmes valeurs de champ et les fusionne pour constituer un seul polygone.

Les limites fusionnées peuvent être contrôlées en spécifiant un ou plusieurs champs. Par exemple, si vous avez une couche de comtés et que chaque comté possède un champ State_Name, vous pouvez fusionner les limites à l’aide du champ State_Name. Les comtés adjacents seront combinés si leur attribut State_Name possède la même valeur. Le résultat est une couche de limites d’États.

Illustration

Utilisation

• Les entités Input Layer (Couche en entrée) doivent avoir une géométrie de polygone. Les entités en sortie fusionnées seront toujours des polygones.

• Deux types de polygones peuvent faire l’objet d’une fusion de leurs limites : les polygones qui s’intersectent et les polygones qui ont la même valeur de champ.

  Les entités surfaciques dont les limites s’intersectent seront fusionnées par défaut. Vous pouvez également utiliser le paramètre Dissolve Field(s) (Champ(s) de fusion) pour fusionner les polygones d'intersection qui ont une ou plusieurs valeurs de champ identiques.

  Par exemple, si vous avez une couche de zones d’étude avec un champ Soil_Type, vous pouvez fusionner les limites en fonction des attributs du champ Soil_Type. Les zones d’étude seront fusionnées si leur attribut Soil_Type possède la même valeur. Le résultat est une couche de zones d’étude par type de sol. Si au moins deux champs sont spécifiés, chaque entité en entrée doit être de valeur identique pour que la limite soit fusionnée.

• Diverses statistiques avec le paramètre Summary Fields (Champs de récapitulation) 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 : 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.

• La sortie de l’outil Fusionner les limites peut inclure des entités multi-parties ou en une seule partie. Une entité multi-parties est définie comme une entité fractionnée en parties non contiguës. Par exemple, l’État d’Hawaï peut être considéré comme une entité multi-parties, car ses parties géométriques sont classées dans un même État. Le paramètre Create multipart features (Créer des entités multi-parties) offre deux options pour créer une sortie multi-parties ou en une seule partie :

  • Vrai (activé) : les entités multi-parties sont créées en sortie, le cas échéant.
  • Faux (non activé) : seules des entités en une seule partie seront créées dans la sortie. Il s’agit de l’option par défaut.

• La table suivante explique comment le paramètre Create multipart features (Créer des entités multi-parties) utilise les options de fusion :

  Mode Fusionner	Multipartie a la valeur faux (par défaut)	Multipartie a la valeur vrai
  Dissolve Field(s) (Champ(s) de fusion) n’est pas spécifié (par défaut).	Trois entités sont créées lorsque toutes les valeurs sont fusionnées et que l’option Multipartie a la valeur faux. Seules les entités superposées sont fusionnées.	Une entité est créée lorsque toutes les valeurs sont fusionnées et que l’option Multipartie a la valeur vrai. En sélectionnant cette option, vous n’obtenez toujours qu'une entité en sortie.
  Dissolve Field(s) (Champ(s) de fusion) est spécifié.	Quatre entités sont créées lorsque la fusion est appliquée en fonction du champ (dans ce cas, le champ correspond à la couleur des points en entrée). Seules les entités superposées présentant la valeur des champs spécifiés sont fusionnées.	Deux entités sont créées lorsque la fusion est appliquée en fonction du champ (dans ce cas, le champ correspond à la couleur des points en entrée) et les multiparties sont autorisées. Les valeurs présentant la même valeur de champ représenteront toujours une seule entité.

• Cet outil de géotraitement est mis en œuvre par Spark. L’analyse est effectuée sur votre ordinateur de bureau en utilisant plusieurs cœurs en parallèle. Pour en savoir plus sur l’exécution de l’analyse, reportez-vous à la rubrique Remarques relatives aux outils GeoAnalytics Desktop.

• Lorsque vous exécutez des outils GeoAnalytics Desktop, l’analyse est effectuée sur votre ordinateur de bureau. Pour des performances optimales, les données doivent être accessibles sur votre bureau. Si vous utilisez une couche d’entités hébergée, nous vous recommandons de faire appel à ArcGIS GeoAnalytics Server. Si vos données ne sont pas enregistrées en local, l’exécution des outils prendra plus de temps. Pour utiliser votre instance ArcGIS GeoAnalytics Server en vue d’une analyse, reportez-vous à la rubrique Outils GeoAnalytics.

Syntaxe

arcpy.gapro.DissolveBoundaries(input_layer, out_feature_class, {multipart}, {dissolve_fields}, fields, summary_fields)

Paramètre	Explication	Type de données
input_layer	La couche contenant les entités surfaciques qui seront fusionnées.	Feature Layer
out_feature_class	Nouvelle classe d’entités contenant les limites fusionnées.	Feature Class
multipart (Facultatif)	Indique si des entités multi-parties peuvent être créées dans la classe d’entités en sortie. MULTI_PART —Des entités multi-parties seront créées. SINGLE_PART —Des entités multi-parties ne seront pas créées. Des entités individuelles seront créées pour chaque partie. Il s’agit de l’option par défaut.	Boolean
dissolve_fields (Facultatif)	Indique si les entités dont les valeurs de champ sont identiques seront fusionnées. NO_DISSOLVE_FIELDS —Les polygones partageant une limite commune (c’est-à-dire adjacents) ou les polygones superposés seront fusionnés en un seul polygone. Il s’agit de l’option par défaut. DISSOLVE_FIELDS —Les polygones dont la ou les valeurs de champ sont identiques seront fusionnés.	Boolean
fields [fields,...]	Le ou les champs à utiliser pour fusionner les entités semblables. Les entités dont la valeur est identique pour chaque champ seront fusionnées.	Field
summary_fields [summary_fields,...]	Statistiques qui seront calculées sur les champs spécifiés. Count (Total) : le nombre de valeurs non nulles. Peut être utilisé sur des champs numériques ou des chaînes. Le nombre de [null, 0, 2] est 2. Sum (Somme) : somme des valeurs numériques dans un champ. La somme des [null, null, 3] est 3. Mean (Moyenne) : moyenne des valeurs numériques. La moyenne des [0, 2, null] est 1. Min : valeur minimale d’un champ numérique. Le minimum de [0, 2, null] est 0. Max : valeur maximale d’un champ numérique. La valeur maximale de [0, 2, null] est 2. Standard Deviation (Écart type) : écart type d’un champ numérique. L'écart type de [1] est null. L'écart type de [null, 1,1,1] est null. Variance : variance d’un champ numérique dans une trace. La variance de [1] est null. La variance de [null, 1, 1, 1] est null. Range (Plage) : plage d’un champ numérique. Elle est calculée comme la valeur minimale soustraite de la valeur maximale. La plage de [0, null, 1] est 1. La plage de [null, 4] est 0. Any (Quelconque) : exemple de chaîne provenant d’un champ de type chaîne. Statistiques qui seront calculées sur les champs spécifiés. COUNT : le nombre de valeurs non nulles. Peut être utilisé sur des champs numériques ou des chaînes. Le nombre de [null, 0, 2] est 2. SUM : somme des valeurs numériques dans un champ. La somme des [null, null, 3] est 3. MEAN : moyenne des valeurs numériques. La moyenne des [0,2, null] est 1. MIN : valeur minimale d’un champ numérique. Le minimum de [0, 2, null] est 0. MAX : valeur maximale d’un champ numérique. La valeur maximale de [0, 2, null] est 2. STDDEV : écart type d’un champ numérique. L'écart type de [1] est null. L'écart type de [null, 1,1,1] est null. VAR : variance d’un champ numérique dans une trace. La variance de [1] est null. La variance de [null, 1,1,1] est null. RANGE : plage d’un champ numérique. Elle est calculée comme la valeur minimale soustraite de la valeur maximale. La plage de [0, null, 1] est 1. La plage de [null, 4] est 0. ANY : exemple de chaîne provenant d’un champ de type chaîne.	Value Table

Exemple de code

Exemple d’utilisation de l’outil DissolveBoundaries (script autonome)

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

# Name: Dissolve_County_Boundaries.py
# Description: Dissolve county features based on common state name attributes
 
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Boundaries.gdb"
# Set local variables
inputLayer = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/USA_counties/FeatureServer/0"
outputName = "USA_State_Boundaries"
statistics = [["population", "SUM"]]
  
# Execute DissolveBoundaries using "STATE" as the Dissolve Field
arcpy.gapro.DissolveBoundaries(inputLayer, outputName, "SINGLE_PART",
                               "DISSOLVE_FIELDS", "STATE", statistics)

Environnements

Système de coordonnées en sortie, Etendue, Espace de travail courant, Facteur de traitement parallèle

Informations de licence

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