Union (Analyse)

Récapitulatif

Calcule une union géométrique des Entités en entrée. Toutes les entités sont enregistrées dans la Classe d'entités en sortie avec les attributs des Entités en entrée auxquelles elles sont superposées.

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}]},...]

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)

Détermine les attributs de la classe d'entités en entrée transférés vers la classe d'entités en sortie.

  • ALLTous les attributs provenant des entités en entrée sont transférés vers la classe d'entités en sortie. Il s'agit des options par défaut.
  • NO_FIDTous les attributs issus des entités en entrée à l'exception du champ FID sont transférés dans 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 des options 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 Union (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction Union 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 Union 2 (script autonome)

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

# unions.py
# Purpose: union 3 feature classes
# Author: ESRI

# 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

Rubriques connexes

Informations de licence

ArcView : Oui
ArcEditor : Oui
ArcInfo : Oui

7/10/2012