Polygones voisins (Analyse)

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 des outils Polygones voisins et Polygones voisins deux par deux

Illustration

Un diagramme d’un polygone source et de ses polygones voisins est présenté.

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)
  Les informations récapitulatives sont consignées dans une table en sortie. Un polygone source peut avoir un ou plusieurs polygones voisins. Un polygone voisin est spatialement associé au polygone source d’au moins une des façons décrites ci-dessus.

• 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 relative au fonctionnement des outils Polygones voisins et Polygones voisins deux par deux pour des détails sur l’utilisation de ce paramètre.

• Vous pouvez utiliser le paramètre Inclure les superpositions de surface pour analyser les relations des surfaces superposées. Lorsque le paramètre Inclure les superpositions de surface est sélectionné, 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 des relations des surfaces superposées est une opération sollicitant beaucoup de ressources, et les performances risquent d’être plus lentes que si vous déterminiez les relations de voisinage au nœud et au tronçon coïncident. Si vous savez que les 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 sélectionné.

  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 le paramètre Inclure les deux côtés de la relation voisine n’est pas sélectionné, seule l’entrée relative à OID1 ayant pour voisin OID2 sera incluse dans la table en sortie.

• Le paramètre Unités linéaires en sortie spécifie les unités à utiliser pour les longueurs des limites partagées 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.

• Le paramètre Unités de surface en sortie n’est utilisé 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

Boîte de dialogue

É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. Désélectionné : les relations des surfaces superposées ne sont ni analysées ni incluses dans la sortie. Il s’agit de l’option par défaut. Sélectionné : les relations des surfaces superposées sont 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. Sélectionné : pour une paire de polygones voisins, les informations relatives au voisinage identifiant le premier polygone comme étant la source et le second comme étant le voisin, ainsi que la relation réciproque, sont incluses. Il s’agit de l’option par défaut. Désactivé - En présence d’une paire de polygones voisins, seules les informations identifiant le premier polygone comme étant la source et le second comme étant le voisin sont incluses. La relation réciproque n’est pas incluse.	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. Inconnu—L’unité de longueur est inconnue. Kilomètres—L’unité de longueur est le kilomètre. Mètres—L’unité de longueur est le mètre. Décimètres—L’unité de longueur est le décimètre. Centimètres—L’unité de longueur est le centimètre. Millimètres—L’unité de longueur est le millimètre. Milles terrestres—L’unité de longueur est le mille terrestre. Milles nautiques internationaux—L’unité de longueur est le mille nautique international. Yards internationaux—L’unité de longueur est le yard international. Pieds internationaux—L’unité de longueur est le pied international. Pouces internationaux—L’unité de longueur est le pouce international. Miles d’arpentage américains—L’unité de longueur est le mille d’arpentage américain. Milles nautiques d’arpentage américains—L’unité de longueur est le mille nautique d’arpentage américain. Yards d’arpentage américains—L’unité de longueur est le yard d’arpentage américain. Pieds d’arpentage américains—L’unité de longueur est le pied d’arpentage américain. Pouces d’arpentage américains—L’unité de longueur est le pouces d’arpentage américain. Degrés décimaux—L’unité de longueur est le degré décimal. Points—L’unité de longueur est le point.	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. Inconnu—L’unité de surface est inconnue. Kilomètres carrés—L’unité de surface est le kilomètre carré. Mètres carrés—L’unité de surface est le mètre carré. Décimètres carrés—L’unité de surface est le décimètre carré. Centimètres carrés—L’unité de surface est le centimètre carré. Millimètres carrés—L’unité de surface est le millimètre carré. Milles terrestres carrés—L’unité de surface est le mille terrestre carré. Milles nautiques internationaux carrés—L’unité de surface est le mille nautique international carré. Yards internationaux carrés—L’unité de surface est le yard international carré. Pieds internationaux carrés—L’unité de surface est le pied international carré. Pouces internationaux carrés—L’unité de surface est le pouce international carré. Milles d’arpentage américains carrés—L’unité de surface est le mille d’arpentage américain carré. Milles nautiques d’arpentage américains carrés—L’unité de surface est le mille nautique d’arpentage américain carré. Yards d’arpentage américains carrés—L’unité de surface est le yard d’arpentage américain carré. Pieds d’arpentage américains carrés—L’unité de surface est le pied d’arpentage américain carré. Pouces d'arpentage américain carrés—L’unité de surface est le pouce d’arpentage américain carré. Acres d’arpentage américaines—L’unité de surface est l’acre d’arpentage américaine. Hectares—L’unité de surface est l’hectare. Acres—L’unité de surface est l’acre internationale. Ares—L’unité de surface est l’are.	String

Python

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 de zones superposées seront analysées et incluses dans la sortie. NO_AREA_OVERLAP—Les relations des surfaces superposées ne sont ni analysées ni incluses dans la sortie. Il s’agit de l’option par défaut. AREA_OVERLAP—Les relations des surfaces superposées sont 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. BOTH_SIDES—Pour une paire de polygones voisins, les informations relatives au voisinage identifiant le premier polygone comme étant la source et le second comme étant le voisin, ainsi que la relation réciproque, sont incluses. Il s’agit de l’option par défaut. NO_BOTH_SIDES—Pour une paire de polygones voisins, seules les informations relatives au voisinage identifiant le premier polygone comme étant la source et le second comme étant le voisin sont incluses. La relation réciproque n’est pas incluse.	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. UNKNOWN—L’unité de longueur est inconnue. KILOMETERS—L’unité de longueur est le kilomètre. METERS—L’unité de longueur est le mètre. DECIMETERS—L’unité de longueur est le décimètre. CENTIMETERS—L’unité de longueur est le centimètre. MILLIMETERS—L’unité de longueur est le millimètre. MILES_INTERNATIONAL—L’unité de longueur est le mille terrestre. NAUTICAL_MILES_INTERNATIONAL—L’unité de longueur est le mille nautique international. YARDS_INTERNATIONAL—L’unité de longueur est le yard international. FEET_INTERNATIONAL—L’unité de longueur est le pied international. INCHES_INTERNATIONAL—L’unité de longueur est le pouce international. MILES—L’unité de longueur est le mille d’arpentage américain. NAUTICAL_MILES—L’unité de longueur est le mille nautique d’arpentage américain. YARDS—L’unité de longueur est le yard d’arpentage américain. FEET—L’unité de longueur est le pied d’arpentage américain. INCHES—L’unité de longueur est le pouces d’arpentage américain. DECIMAL_DEGREES—L’unité de longueur est le degré décimal. POINTS—L’unité de longueur est le point.	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. UNKNOWN—L’unité de surface est inconnue. SQUARE_KILOMETERS—L’unité de surface est le kilomètre carré. SQUARE_METERS—L’unité de surface est le mètre carré. SQUARE_DECIMETERS—L’unité de surface est le décimètre carré. SQUARE_CENTIMETERS—L’unité de surface est le centimètre carré. SQUARE_MILLIMETERS—L’unité de surface est le millimètre carré. SQUARE_MILES—L’unité de surface est le mille terrestre carré. SQUARE_NAUTICAL_MILES—L’unité de surface est le mille nautique international carré. SQUARE_YARDS—L’unité de surface est le yard international carré. SQUARE_FEET—L’unité de surface est le pied international carré. SQUARE_INCHES—L’unité de surface est le pouce international carré. SQUARE_MILES_US—L’unité de surface est le mille d’arpentage américain carré. SQUARE_NAUTICAL_MILES_US—L’unité de surface est le mille nautique d’arpentage américain carré. SQUARE_YARDS_US—L’unité de surface est le yard d’arpentage américain carré. SQUARE_FEET_US—L’unité de surface est le pied d’arpentage américain carré. SQUARE_INCHES_US—L’unité de surface est le pouce d’arpentage américain carré. ACRES_US—L’unité de surface est l’acre d’arpentage américaine. HECTARES—L’unité de surface est l’hectare. ACRES—L’unité de surface est l’acre internationale. ARES—L’unité de surface est l’are.	String

Exemple de code

Exemple d’utilisation de l'outil PolygonNeighbors (fenêtre Python)

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

Validation automatique, Noms de champ qualifiés, Étendue, Espace de travail temporaire, Espace de travail courant, Facteur de traitement parallèle

Cas particuliers

Facteur de traitement parallèle

Cet outil respecte l'environnement Facteur de traitement parallèle. Si l’environnement n’est pas défini (comportement par défaut) ou s’il est défini sur 0, le traitement parallèle est désactivé ; le traitement parallèle n’est pas utilisé et le traitement est effectué séquentiellement. Le fait de définir l’environnement sur 100 permet un traitement parallèle ; le traitement parallèle est utilisé et le traitement est effectué en parallèle. Jusqu’à 10 cœurs seront utilisés lorsque le traitement parallèle sera activé.

Informations de licence

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