Étiquette | Explication | Type de données |
Entités en entrée
| 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 |
Classe d'entités en sortie
| Classe d’entités en sortie contenant le nombre de superposition. | Feature Class |
Nombre total minimal des entités superposées
(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 |
Table de superposition en sortie
(Facultatif) | Table en sortie contenant les enregistrements de chacune des géométries superposées. | Table |
Synthèse
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.
Paramètres
arcpy.analysis.CountOverlappingFeatures(in_features, out_feature_class, {min_overlap_count}, {out_overlap_table})
Nom | 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
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")
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
Cas particuliers
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?