Étiquette | Explication | Type de données |
Entités en entrée | Entités surfaciques en entrée. | Feature Layer |
Table en sortie | Table en sortie. | Table |
Signaler par champs (Facultatif) | Le ou les champs attributaires en entrée allant être utilisés pour identifier des polygones uniques ou des groupes de polygones et les représenter dans la sortie. | Field |
Inclure les superpositions de surface (Facultatif) | Spécifie si les relations de zones superposées seront analysées et incluses dans la sortie.
| Boolean |
Inclure les deux côtés de la relation voisine (Facultatif) | Spécifie si les deux côtés des relations de voisinage sont incluses dans la sortie.
| Boolean |
Tolérance XY (Facultatif) | Distance minimale entre des coordonnées avant qu’elles ne soient considérées comme identiques. Par défaut, il s’agit de la tolérance x,y des entités en entrée. Attention :Modifier la valeur de ce paramètre peut provoquer des erreurs ou des résultats inattendus. Il est recommandé de ne pas modifier ce paramètre. Ce paramètre n’est plus affiché dans la boîte de dialogue de l’outil. Par défaut, la propriété Tolérance x,y de la référence spatiale de la classe d’entités en entrée est utilisée. | Linear Unit |
Unités linéaires en sortie (Facultatif) | Spécifie les unités allant être utilisées pour signaler la longueur totale du tronçon coïncident entre des polygones voisins. Par défaut, il s'agit de l'unité des entités en entrée.
| String |
Unités de zone en sortie (Facultatif) | Spécifie l'unité utilisée pour signaler la superposition de surface des polygones voisins. Par défaut, il s'agit de l'unité des entités en entrée. Ce paramètre n’est actif que si vous activez le paramètre Inclure les superpositions de surface.
| String |
Synthèse
Crée une table avec des statistiques basées sur la contiguïté des polygones (superpositions, tronçons coïncidents ou nœuds).
En savoir plus sur le fonctionnement de l’outil Polygones voisins
Illustration
Utilisation
L’outil analyse la contiguïté du polygone, en récapitulant les aspects suivants entre les polygones source et les polygones voisins :
- la surface de superposition (voisins superposés - en option)
- la longueur des tronçons coïncidents (voisins au nœud)
- le nombre de fois où des limites se croisent ou se touchent en un point (voisin au nœud)
Seule la contiguïté de premier ordre est analysée et signalée par l’outil. Les relations allant au-delà ne sont pas examinées. En d’autres termes, les voisins des voisins (contiguïté de second ordre) ne sont pas examinés.
Le paramètre Signaler par champs permet d’identifier des polygones uniques ou des groupes de polygones et de communiquer leurs informations de voisinage par polygone unique ou groupes de polygones. Pour trouver les voisins de chaque polygone dans l’entrée, indiquez un ou plusieurs champs en entrée produisant une valeur unique ou un ensemble de valeurs (si vous utilisez plusieurs champs) pour chaque polygone.
Si les champs spécifiés identifient des groupes de polygones uniques, les informations sur le voisinage sont récapitulées et signalées par les groupes.
Reportez-vous à la rubrique Fonctionnement de l’outil Polygones voisins pour savoir comment utiliser ce paramètre.
Vous pouvez utiliser le paramètre Inclure les superpositions de surface pour analyser les relations de superposition de zone. Lorsque vous sélectionnez l’option Inclure les superpositions de surface, la table en sortie contient un champ AREA qui stocke la surface de superposition du voisin superposé en cours d’analyse. En l’absence de superposition, le champ AREA a pour valeur 0.
Conseil :
Le calcul de relations de superposition de surfaces est une opération sollicitant beaucoup de ressources, et les performances risquent d’être bien plus lentes que si vous déterminiez les relations de voisinage au nœud et au tronçon coïncident. Si vous savez que vos données ne présentent aucune entité superposée ou si vous ne souhaitez pas analyser les voisins superposés, assurez-vous que le paramètre Inclure les superpositions de surface n’est pas coché.
Attention :
Le paramètre Inclure les superpositions de surface doit être coché en vue de l’obtention des enregistrements des voisins figurant entièrement dans un polygone source. Si vous ne cochez pas le paramètre Inclure les superpositions de surface, la table en sortie ne contient pas les enregistrements des voisins figurant entièrement dans un polygone source.
Il n'y a aucune entrée dans la table en sortie pour les entités non voisines.
Le paramètre Inclure les deux côtés de la relation voisine est utilisé pour contrôler les relations incluses dans la sortie. Pour signaler toutes les relations de contiguïté, y compris les relations réciproques, cochez la case Inclure les deux côtés de la relation voisine. Par exemple, si OID1 est un voisin d’OID2, une entrée est ajoutée dans la table en sortie pour OID1 ayant pour voisin OID2, et pour OID2 ayant pour voisin OID1. Si vous ne désirez que le premier côté de la relation, décochez le paramètre Inclure les deux côtés de la relation voisine. Toujours avec cet exemple, si l’option Inclure les deux côtés de la relation voisine est désactivée, seule l’entrée relative à OID1 ayant pour voisin OID2 sera consignée dans la table en sortie.
L’option Unités linéaires en sortie spécifie les unités allant être utilisées pour la longueur de limite mitoyenne entre voisins. Par défaut, les unités utilisées sont les mêmes que celles définies par le système de coordonnées d'entités en entrée.
L’option Unités de surface en sortie n’est utilisée que lorsque le paramètre Inclure les superpositions de surface est sélectionné. Lorsque le paramètre Inclure les superpositions de surface est activé, les unités utilisées pour calculer la superposition de surfaces des voisins sont spécifiées dans le paramètre Unités de surface en sortie. Par défaut, les unités utilisées sont les mêmes que celles définies par le système de coordonnées de l'entité en entrée.
La valeur du paramètre Table en sortie peut être une table de géodatabase fichier ou une table .dbf.
Pour chaque champ spécifié dans le paramètre Signaler par champs, la table en sortie contient deux champs utilisant la convention de nom suivante : src_<field> et nbr_<field>. Les champs représentent les valeurs des champs source et voisins de l’entrée.
La table en sortie contient également les champs suivants :
- AREA- Ce champ stocke la surface totale superposée entre un polygone source et un polygone voisin (voisins superposés). Ce champ n’est inclus dans la table en sortie que si le paramètre Inclure les superpositions de surface est coché.
- LENGTH- Ce champ stocke la longueur totale des tronçons coïncidents entre un polygone source et un polygone voisin.
- NODE_COUNT- Ce champ stocke le nombre de croisements ou de contacts en un point entre un polygone source et un polygone voisin.
Si une sélection est définie sur les entités en entrée, seules les entités sélectionnées sont analysées.
Paramètres
arcpy.analysis.PolygonNeighbors(in_features, out_table, {in_fields}, {area_overlap}, {both_sides}, {cluster_tolerance}, {out_linear_units}, {out_area_units})
Nom | Explication | Type de données |
in_features | Entités surfaciques en entrée. | Feature Layer |
out_table | Table en sortie. | Table |
in_fields [in_fields,...] (Facultatif) | Le ou les champs attributaires en entrée allant être utilisés pour identifier des polygones uniques ou des groupes de polygones et les représenter dans la sortie. | Field |
area_overlap (Facultatif) | Spécifie si les relations superposées seront analysées et incluses dans la sortie.
| Boolean |
both_sides (Facultatif) | Spécifie si les deux côtés des relations de voisinage sont incluses dans la sortie.
| Boolean |
cluster_tolerance (Facultatif) | Distance minimale entre des coordonnées avant qu’elles ne soient considérées comme identiques. Par défaut, il s’agit de la tolérance x,y des entités en entrée. Attention :Modifier la valeur de ce paramètre peut provoquer des erreurs ou des résultats inattendus. Il est recommandé de ne pas modifier ce paramètre. Ce paramètre n’est plus affiché dans la boîte de dialogue de l’outil. Par défaut, la propriété Tolérance x,y de la référence spatiale de la classe d’entités en entrée est utilisée. | Linear Unit |
out_linear_units (Facultatif) | Spécifie les unités allant être utilisées pour signaler la longueur totale du tronçon coïncident entre des polygones voisins. Par défaut, il s'agit de l'unité des entités en entrée.
| String |
out_area_units (Facultatif) | Spécifie l'unité utilisée pour signaler la superposition de surface des polygones voisins. Par défaut, il s'agit de l'unité des entités en entrée. Ce paramètre n’est activé que lorsque le paramètre area_overlap est défini sur AREA_OVERLAP.
| String |
Exemple de code
Recherchez tous les voisins des districts électoraux dans la province de Nouvelle-Écosse.
import arcpy
arcpy.management.MakeFeatureLayer(r"C:\Data\Canada\CanadaElecDist.shp",
"Canada_ElectoralDist")
arcpy.management.SelectLayerByAttribute("Canada_ElectoralDist", "NEW_SELECTION",
"\"PROVCODE\" = 'NS'")
count = arcpy.management.GetCount("Canada_ElectoralDist")[0]
print("Selected feature count: {}".format(count))
arcpy.analysis.PolygonNeighbors("Canada_ElectoralDist",
r"C:\Data\Output\NS_elec_neigh.dbf", "ENNAME")
print(arcpy.GetMessages())
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?