Total des entités superposées (Analyse)

Résumé

Génère des entités superposées planarisées à partir des entités en entrée. Le nombre total d’entités superposées est écrit dans les entités en sortie.

Illustration

Utilisation

• Le type de géométrie en sortie est identique à celui en entrée, à l’exception de la géométrie ponctuelle. Pour la géométrie ponctuelle, la sortie est une classe d’entités multi-points s’il existe plusieurs classes d’entités en entrée ou bien une classe d’entités ponctuelles s’il existe une seule classe d’entités ponctuelles en entrée.

• La sortie est l’union planarisée des entrées. On évalue la superposition entre les entités décalées verticalement (géométrie avec des valeurs z différentes) comme si toutes les entités subissaient un aplatissement sur le même plan.

  Pour la géométrie de polygone, une surface occupée par deux entités ou plus est considérée comme une superposition. Pour la géométrie de ligne, les lignes doivent se chevaucher complètement (un segment de ligne est incident d’un autre segment) pour être considérées comme superposées. Les lignes qui se coupent en un point ne sont pas considérées comme étant superposées. Pour la géométrie de point, tous les points coïncidents se superposent.

• Les champs suivants sont ajoutés à la classe d’entités en sortie (option Output Feature Class) :

  • COUNT_ : nombre d’entités superposées en entrée
  • COUNT_FC : nombre de classes d’entités individuelles superposées avec l’entité

  Tous les autres champs des entités en entrée (option Input Features) sont exclus de la classe d’entités en sortie (option Output Feature Class).

• Lorsqu’une table de superposition en sortie (Output Overlap Table) est générée, elle inclut un enregistrement par superposition. Par exemple, lorsque trois entités en entrée se superposent sur le même emplacement, la table comporte trois enregistrements pour cet emplacement, à savoir un pour chaque géométrie superposée. Les champs suivants sont inclus dans la table de regroupement en sortie (Output Overlap Table) :

  • OVERLAP_OID : ObjectID de l’entité Output Feature Class (Classe d’entités en sortie) associée.
  • ORIG_OID : ObjectID de l’entité Input Features (Entités en entrée) associée.
  • ORIG_NAME : ce champ est ajouté en cas d’entrées multiples. Le champ contient le nom de l’entrée.

  Cette table permet d’associer chaque superposition aux entités en entrée et en sortie.

Syntaxe

arcpy.analysis.CountOverlappingFeatures(in_features, out_feature_class, {min_overlap_count}, {out_overlap_table})

Paramètre	Explication	Type de données
in_features [in_features,...]	Classes ou couches d’entités en entrée. Entités en entrée qui peuvent être de type points, multi-points, lignes ou polygones. Si plusieurs entrées sont spécifiées, elles doivent toutes être du même type de géométrie.	Feature Layer
out_feature_class	Classe d’entités en sortie contenant le nombre de superposition.	Feature Class
min_overlap_count (Facultatif)	Limite la sortie aux seuls emplacements satisfaisant ou dépassant le nombre spécifié de superpositions. La valeur par défaut est 1.	Long
out_overlap_table (Facultatif)	Table en sortie contenant les enregistrements de chacune des géométries superposées.	Table

Exemple de code

Exemple d’utilisation de la fonction CountOverlappingFeatures (fenêtre Python)

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

import arcpy
arcpy.env.workspace = r"C:\data\data.gdb"
arcpy.CountOverlappingFeatures_analysis("Viewsheds", "Viewshed_Overlaps")

Exemple 2 d’utilisation de la fonction CountOverlappingFeatures (script autonome)

Le code suivant décrit la procédure d’utilisation de la fonction CountOverlappingFeatures afin d’obtenir le nombre de superpositions en présence de trois opérateurs de téléphonie mobile. Il décrit également l’utilisation du paramètre min_overlap_count pour limiter la sortie aux seules zones couvertes par les trois opérateurs.

# CountOverlappingFeatures_Example_2.py
# Description: Count number of cellular service providers for given area
# Import the system modules
import arcpy
# Set current workspace
arcpy.env.workspace = r"C:\data\data.gdb"
# Set input parameters
provider_a = 'Provider_A_ServiceArea'
provider_b = 'Provider_B_ServiceArea'
provider_c = 'Provider_C_ServiceArea'
in_fcs  = [provider_a, provider_b, provider_c]
# Set output feature names
out_fc = 'CellularProviders_Count'
out_tbl = 'CelluarProviders_Count_Tbl'
# Obtain overlap count for three overlapping input feature classes
# and use minimum_overlap_count parameter to limit the output to only 
# those areas where all three overlap.
arcpy.CountOverlappingFeatures_analysis(in_fcs, out_fc, 3, out_tbl)

Environnements

Valeur Z en sortie par défaut, Résolution M, Tolérance M, Domaine M en sortie, Système de coordonnées en sortie, Transformations géographiques, Espace de travail temporaire, Valeurs M en sortie, Valeurs Z en sortie, Résolution XY, Tolérance XY, Résolution Z, Tolérance Z, Espace de travail courant, Mot-clé de configuration en sortie

Informations de licence

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