Générer la table de proximité (Outils d'analyse)

Résumé

Calcule les distances et autres informations de proximité entre les entités dans une ou plusieurs classes d’entités ou couches. À la différence de l’outil Proche, qui modifie l’entrée, l’outil Générer la table de proximité écrit les résultats dans une nouvelle table autonome et permet de rechercher plusieurs entités de proximité.

En savoir plus sur le calcul de la proximité par les outils de géotraitement

Illustration

Utilisation

• La table en sortie contient les champs suivants :

  • IN_FID—ID d’objet de l’entité en entrée.

  • NEAR_FID—ID d’objet de l’entité la plus proche.

  • NEAR_DIST—Distance entre l’entrée en entrée et l’entité de proximité. La valeur est exprimée dans l’unité linéaire du système de coordonnées de l’entité en entrée ou en mètres si le paramètre Method (Méthode) est défini sur Geodesic (Géodésique) et que l’entrée est dans un système de coordonnées géographiques.

  • NEAR_FC—Chemin d’accès du catalogue à la classe d’entités qui contient l’entité de proximité. Ce champ est ajouté à la table en sortie uniquement si plusieurs valeurs de paramètre Near Features (Entités de proximité) sont spécifiées.

  • NEAR_RANK—Valeur d’entier classant toutes les entités de proximité selon leur proximité par rapport à une entité en entrée individuelle. L’entité la plus proche obtient une valeur égale à 1, la deuxième plus proche obtient une valeur égale à 2, etc.

  Les champs ci-dessous sont ajoutés à la table en sortie si le paramètre Location (Localisation) est sélectionné. L’unité de valeur de champ dépend de la valeur du paramètre Method (Méthode). Si le paramètre Method (Méthode) est défini sur Planar (Planaire), la valeur de champ est exprimée dans l’unité linéaire du système de coordonnées de l’entité en entrée. S’il est défini sur Geodesic (Géodésique), la valeur de champ est exprimée dans le système de coordonnées géographiques associé au système de coordonnées de l’entité en entrée.

  • FROM_X—Coordonnée X de l’emplacement de l’entité en entrée la plus proche de l’entité de proximité.

  • FROM_Y—Coordonnée Y de l’emplacement de l’entité en entrée la plus proche de l’entité de proximité.

  • NEAR_X—Coordonnée X de l’emplacement de l’entité de proximité la plus proche de l’entité en entrée.

  • NEAR_Y—Coordonnée Y de l’emplacement de l’entité de proximité la plus proche de l’entité en entrée.

  Le champ suivant est ajouté à la table en sortie si le paramètre Angle est sélectionné :

  • NEAR_ANGLE—Angle de la ligne aux emplacements FROM_X et FROM_Y qui relie les entités en entrée à l’entité de proximité.

• Lorsque l’entité en entrée et l’entité de proximité s’intersectent, les valeurs suivantes sont écrites dans la table en sortie :

  • NEAR_ANGLE et NEAR_DIST sont définis sur 0.0.

  • FROM_X et FROM_Y sont identiques à NEAR_X et NEAR_Y est un emplacement dans l’intersection des deux entités.

• Les valeurs du champ NEAR_DIST seront exprimées dans l’unité linéaire du système de coordonnées des entités en entrée. Si l’entrée se trouve dans un système de coordonnées géographiques, et que le paramètre Method (Méthode) est défini sur Geodesic (Géodésique), l’unité du champ NEAR_DIST est le mètre.

• La table en sortie peut être jointe aux entités en entrée à l’aide du champ IN_FID ou aux entités de proximité à l’aide du champ NEAR_FID.

• Si la valeur du paramètre Search Radius (Rayon de recherche) est spécifiée et qu’aucune entité de proximité n’est trouvée, aucun enregistrement n’est généré en sortie.

• Si la valeur du paramètre Search Radius (Rayon de recherche) n’est pas spécifiée, toutes les entités de proximité sont considérées comme des candidats.

• Si la valeur du paramètre Search Radius (Rayon de recherche) n’est pas spécifiée, que le paramètre Find only closest feature (Rechercher uniquement l’entité la plus proche) n’est pas sélectionné et que le paramètre Maximum number of closest matches (Nombre maximal de résultats les plus proches) est défini sur la valeur par défaut (0 ou vide), la table en sortie contient des calculs de distance entre toutes les entités en entrée et toutes les entités de proximité. Ce processus peut prendre du temps et produire une table en sortie volumineuse. Par exemple, si vous avez mille entités en entrée et mille entités de proximité, la table en sortie contient un million d’enregistrements.

• Pour calculer la distance et des informations de proximité supplémentaires au sein d’une seule classe d’entités ou couche, la même classe d’entités ou couche peut être utilisée. Dans ce cas, l’entité en entrée en cours d’évaluation est exclue des candidats d’entités en entrée, afin d’éviter que toutes les entités soient les plus proches d’elles-mêmes.

• Lorsque vous utilisez l’option Planar (Planaire) pour le paramètre Method (Méthode), utilisez une projection des entités en entrée adéquate pour une mesure de distance (une projection équidistante, par exemple).

  En savoir plus sur les systèmes de coordonnées et les projections.

• Pour visualiser les valeurs des champs FROM_X, FROM_Y, NEAR_X et NEAR_Y, la table en sortie peut être utilisée en tant qu’entrée pour l’outil Make XY Event Layer (Créer une couche d’événements XY) ou XY vers lignes.

• You can set a unit of measurement for the NEAR_DIST —comme les mètres, kilomètres ou miles—en utilisant le paramètre Distance Unit (Unité de distance).

Paramètres

• Dialog
• Python

Etiqueter	Explication	Type de données
Input Features (Entités en entrée)	Les entités en entrée peuvent être de type point, polyligne, polygone ou multi-point.	Feature Layer
Entités de proximité	Une ou plusieurs couches d’entités ou classes d’entités contenant des candidats d’entités de proximité. Les entités de proximité peuvent être de type point, polyligne, polygone ou multi-points. Si plusieurs couches ou classes d’entités sont spécifiées, un champ nommé NEAR_FC est ajouté à la table en entrée pour stocker les chemins de la classe d’entités source contenant l’entité la plus proche trouvée. La même classe d’entités ou couche peut être utilisée à la fois sur des entités en entrée et de proximité.	Feature Layer
Table en sortie	Table en sortie contenant le résultat de l’analyse.	Table
Rayon de recherche (Facultatif)	Rayon utilisé pour rechercher les entités de proximité. Si aucune valeur n’est spécifiée, toutes les entités de proximité sont prises en compte. Si une distance sans unité ou inconnue est spécifiée, les unités du système de coordonnées des entités en entrée sont utilisées. Si l’option Geodesic (Géodésique) est utilisée pour le paramètre Method (Méthode), utilisez une unité linéaire, telle que les kilomètres ou les miles.	Linear Unit
Emplacement (Facultatif)	Spécifie si les coordonnées x et y de l’emplacement de l’entité en entrée et de l’emplacement le plus proche de l’entité de proximité sont écrites dans les champs FROM_X, FROM_Y, NEAR_X et NEAR_Y. Activé—Les emplacements sont écrits dans la table en sortie. Décoché—Les emplacements ne sont pas écrits dans la table en sortie. Il s’agit de l’option par défaut.	Boolean
Angle (Facultatif)	Spécifie si les valeurs d’angle de proximité sont calculées et écrites dans un champ NEAR_ANGLE dans la table en sortie. Un angle de proximité mesure la direction de la ligne qui connecte une entité en entrée avec son entité la plus proche à leur emplacement le plus proche. Lorsque la méthode PLANAR est utilisée dans le paramètre method, l’angle se situe dans la plage -180° à 180°, avec 0° à l’est, 90° au nord, 180° (ou -180°) à l’ouest et -90° au sud. Lorsque la méthode GEODESIC est utilisée dans le paramètre method, l’angle est compris entre -180° et 180°, avec 0° au nord, 90° à l’est, 180° (ou -180°) au sud et -90° à l’ouest. Activé—L’angle de proximité est calculé et le champ NEAR_ANGLE est ajouté à la table en sortie. Décoché—L’angle de proximité n’est pas calculé et le champ NEAR_ANGLE n’est pas ajouté à la table en sortie. Il s’agit de l’option par défaut.	Boolean
Rechercher uniquement l’entité la plus proche (Facultatif)	Spécifie si seule l’entité de proximité la plus proche est écrite dans la table en sortie. Activé—Seul l’emplacement de l’entité la plus proche est écrit dans la table en sortie. Il s’agit de l’option par défaut. Décoché—Plusieurs entités de proximité sont écrites dans la table en sortie (vous pouvez préciser une limite dans le paramètre closest_count).	Boolean
Nombre maximal de résultats les plus proches (Facultatif)	Limitez le nombre d’entités de proximité signalées pour chaque entité en entrée. Ce paramètre est inactif si le paramètre Find only closest feature (Rechercher uniquement l’entité la plus proche) est activé.	Long
Méthode (Facultatif)	Spécifie si le chemin le plus court sera utilisé sur une sphéroïde (géodésique) ou une méthode de distance de terre plate (planaire). Il est recommandé d’utiliser la méthode Geodesic (Géodésique) avec des données stockées dans un système de coordonnées non approprié pour les mesures de distance (Web Mercator ou tout système de coordonnées géographiques, par exemple) et pour un jeu de données couvrant une vaste zone géographique. plane—Une distance planaire est utilisée entre les entités. Il s’agit de l’option par défaut. Géodésique—Une distance géodésique est utilisée entre les entités. Cette méthode tient compte de la courbure du sphéroïde et gère correctement les données situées à proximité de la ligne de changement de date et des pôles.	String
Unité de distance (Facultatif)	Indique l’unité de mesure du champ NEAR_DIST. Si aucune unité de mesure n’est spécifiée, les valeurs dans le champ NEAR_DIST sont exprimées dans l’unité linéaire du système de coordonnées de l’entité en entrée. Si l’entrée est exprimée dans un système de coordonnées géographiques et que la méthode géodésique est utilisée, les unités du champ NEAR_DIST sont les mètres. Kilomètres—L’unité est le kilomètre. Mètres—L’unité est le mètre. Milles nautiques internationaux—L’unité est le mille nautique international. Milles terrestres—L’unité est le mille terrestre. Yards internationaux—L’unité est le yard international. Pied international—L’unité est le pied international. Milles nautiques d’arpentage américains—L’unité est le mille nautique d’arpentage américain. Milles d’arpentage américains—L’unité est le mille d’arpentage américain. Yards d'arpentage américains—L’unité est le yard d’arpentage américain. Pieds d’arpentage américains—Les pieds d’arpentage U.S sont l’unité.	String
Champs d'appariement (Facultatif)	La paire de champs des entités en entrée et des entités de proximité qui seront utilisées pour l’appariement des attributs. Seules les entités de proximité qui partagent des valeurs de champ de correspondance avec des entités en entrée seront utilisées pour le calcul de proximité. Colonnes de la table de valeurs : Input Fields—Fields from the input features that will be used for attribute matching. Near Fields—Fields from the near features that will be used for attribute matching.	Value Table

Environnements

Espace de travail courant, Espace de travail temporaire, Etendue

Informations de licence

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

Rubriques connexes

• Vue d’ensemble du jeu d’outils Proximité
• Rechercher un outil de géotraitement