Agréger (Analyse)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Calcule une union géométrique des entités en entrée. Toutes les entités et les attributs correspondants sont inscrits dans la classe d'entités en sortie.

Pour en savoir plus sur l'utilisation de la fonction Agréger

Illustration

Illustration de la fonction Agréger

Utilisation

Syntaxe

Union_analysis (in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {gaps})
ParamètreExplicationType de données
in_features
[[in_features, {Rank}],...]

La liste des classes ou couches d'entités en entrée. Lorsque la distance entre les entités est inférieure à la tolérance d'agrégat, les entités de classement inférieur s'alignent sur l'entité de classement le plus élevé. Le classement le plus élevé est 1. Toutes les entités en entrée doivent être des polygones.

Value Table
out_feature_class

Classe d'entités devant contenir les résultats.

Feature Class
join_attributes
(Facultatif)

Identifie les attributs des entités en entrée qui sont transférés vers la classe d'entités en sortie.

  • ALLTous les attributs des entités en entrée sont transférés vers la classe d'entités en sortie. Il s'agit du comportement par défaut.
  • NO_FIDTous les attributs des entités en entrée à l'exception du champ FID sont transférés vers la classe d'entités en sortie.
  • ONLY_FIDSeul le champ FID des entités en entrée est transféré vers la classe d'entités en sortie.
String
cluster_tolerance
(Facultatif)

La distance minimum séparant toutes les coordonnées d'entité (nœuds et sommets) ainsi que la distance de déplacement possible d'une coordonnée sur X ou Y (ou les deux).

Linear unit
gaps
(Facultatif)

Les interruptions sont des surfaces de la classe d'entités en sortie entièrement entourées par d'autres polygones. Cela ne constitue pas une opération non valide, mais il est préférable de les identifier à des fins d'analyse. Pour rechercher les interruptions dans la sortie, définissez l'option sur la valeur NO_GAPS afin de créer une entité dans ces surfaces. Pour sélectionner ces entités, effectuez une requête sur la classe d'entités en sortie portant sur les valeurs FID de toutes les entités en entrée égales à -1.

  • GAPSAucune entité n'est créée pour les zones de la sortie entièrement entourées par des polygones. Il s'agit de l'option par défaut.
  • NO_GAPSUne entité est créée pour les zones de la sortie entièrement entourées par des polygones. Cette entité possède des attributs vides.
Boolean

Exemple de code

Exemple d'utilisation de l'outil Agréger (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction Agréger en mode immédiat.

import arcpy
from arcpy import env
env.workspace = "C:/data/data/gdb"
arcpy.Union_analysis (["well_buff50", "stream_buff200", "waterbody_buff500"], "water_buffers", "NO_FID", 0.0003)
arcpy.Union_analysis ([["counties", 2],["parcels", 1],["state", 2]], "state_landinfo")
Exemple d'utilisation de l'outil Agréger 2 (script autonome)

Le script autonome ci-dessous illustre deux applications possibles de la fonction Agréger dans l'écriture de scripts.

# unions.py
# Purpose: union 3 feature classes

# Import the system modules
import arcpy
from arcpy import env
 
# Set the current workspace 
# (to avoid having to specify the full path to the feature classes each time)
env.workspace = "c:/data/data.gdb"
 

# Union 3 feature classes but only carry the FID attributes to the output
inFeatures = ["well_buff50", "stream_buff200", "waterbody_buff500"]
outFeatures = "water_buffers"
clusterTol = 0.0003
arcpy.Union_analysis (inFeatures, outFeatures, "ONLY_FID", clusterTol)

# Union 3 other feature classes, but specify some ranks for each 
# since parcels has better spatial accuracy
inFeatures = [["counties", 2],["parcels", 1],["state", 2]]
outFeatures = "state_landinfo" 
arcpy.Union_analysis (inFeatures, outFeatures)

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Limité
ArcGIS for Desktop Standard: Limité
ArcGIS for Desktop Advanced: Oui
5/10/2014