Générer la table de proximité (Analyse)
Récapitulatif
Permet de déterminer les distances entre chaque entité des entités en entrée et une ou plusieurs entités rapprochées dans les entités de proximité, à l'intérieur du rayon de recherche. Les résultats sont enregistrés dans la table en sortie.
Illustration
 |
Utilisation
-
Cet outil a le même comportement que l'outil Proche. En revanche, au lieu de mettre à jour les entités en entrée, il crée une table en sortie. De plus, il permet de rechercher au maximum le nombre d'entités proches spécifié par le paramètre Nombre max. de résultats les plus proches.
La table en sortie contient par défaut les trois champs IN_FID, NEAR_FID et NEAR_DIST. Des champs supplémentaires sont ajoutés à la sortie en fonction des paramètres facultatifs sélectionnés, comme indiqué dans l'entrée de paramètre.
-
La table en sortie peut être jointe à la classe d'entités en entrée d'origine ou à une classe d'entités de proximité à l'aide des champs INPUT_FID ou NEAR_FID.
-
Les entités en entrée et les entités de proximité peuvent être des points, des multi-points, des lignes ou des polygones.
-
L'option par défaut pour cet outil correspond à déterminer la distance entre chaque entité en entrée et l'entité de proximité la plus rapprochée. Sélectionnez l'option ALL (désactivez le paramètre Rechercher uniquement l'entité la plus proche), pour créer une table contenant la distance entre toutes les entités en entrée et toutes les entités de proximité.
-
NEAR_FID et NEAR_DIST ont la valeur -1 si aucune entité n'est trouvée dans le rayon de recherche.
-
Si aucun Rayon de recherche n'est spécifié, un rayon suffisamment grand est utilisé afin que toutes les Entités de proximité puissent être incorporées dans le calcul de la distance. Si le Rayon de recherche par défaut est utilisé (aucun rayon n'est spécifié), la Table en sortie peut être relative grande. Par exemple, le calcul de distances de 1 000 points dans une classe d'entités à 1 000 points dans une autre classe d'entités peut produire une table en sortie contenant un million enregistrements. Utilisez le rayon de recherche pour limiter le nombre d'enregistrements en sortie.
-
Les Entités en entrée et les Entités de proximité peuvent correspondre au même jeu de données. Dans ce cas, lorsque les entités en entrée et de proximité correspondent au même enregistrement, ce résultat est ignoré afin de ne pas signaler que chaque entité est à 0 unité d'elle-même.
Syntaxe
| Paramètre | Explication | Type de données |
in_features |
Entités en entrée qui peuvent être de type point, polyligne, polygone ou multi-points. | Feature Layer |
near_features [near_features,...] |
Entités de proximité utilisées pour retrouver les entités les plus proches d'entités en entrée. Il peut y avoir une ou plusieurs entrées d'entités de proximité ; chaque entrée peut être de type point, polyligne, polygone ou multi-points. Lorsque plusieurs entrées d'entités de proximité sont spécifiées, un nouveau champ NEAR_FC est ajouté à la table en entrée pour stocker les chemins d'accès de la classe d'entités source qui contient les entités les plus proches. | Feature Layer |
out_table |
Table en sortie devant accueillir les informations de proximité telles que IN_FID, NEAR_FID, NEAR_DIST et d'autres attributs tels que la position (NEAR_X, NEAR_Y) ou l'angle (NEAR_ANGLE) de l'entité de proximité, ainsi que NEAR_FC, si nécessaire. | Table |
search_radius (Facultatif) |
Spécifie le rayon utilisé pour rechercher les entités de proximité candidates. Les entités de proximité dans ce rayon sont prises en compte pour le calcul de l'entité la plus proche. Si aucune valeur n'est spécifiée, autrement dit si le rayon par défaut (vide) est utilisé, toutes les entités de proximité sont prises en compte pour le calcul. Vous pouvez spécifier toute unité de distance qui remplace l'unité par défaut des entités en entrée. | Linear unit |
location (Facultatif) |
Spécifie si les coordonnées y et y de l'emplacement le plus proche de l'entité de proximité seront écrites dans de nouveaux champs, à savoir respectivement NEAR_X et NEAR_Y.
| Boolean |
angle (Facultatif) |
Spécifie si les valeurs d'angle de proximité en degrés décimaux seront calculées et écrites dans un nouveau champ, NEAR_ANGLE. Un angle de proximité effectue une mesure de l'axe des x (axe horizontal) dans la direction de la ligne qui connecte une entité en entrée avec son entité la plus proche à leurs emplacements les plus proches ; cette valeur est comprise dans une plage allant de 0 à 180 ou de 0 à -180 degrés décimaux.
| Boolean |
closest (Facultatif) |
Détermine s'il faut localiser et renvoyer uniquement les entités les plus proches ou toutes les entités situées dans le rayon de recherche.
| Boolean |
closest_count (Facultatif) |
Rechercher uniquement le nombre spécifié d'entités les plus proches. Ce paramètre n'est pas utilisé si l'option Rechercher uniquement l'entité la plus proche est activée. | Long |
Exemple de code
L'extrait ci-dessous illustre l'utilisation de la fonction GenerateNearTable dans la fenêtre Python.
import arcpy
arcpy.env.workspace = "C:/data/input/gnt.gdb"
arcpy.GenerateNearTable_analysis("campsites", ["parks", "trails"], "better_sites")
Le script Python ci-dessous illustre l'utilisation de la fonction GenerateNearTable dans un script autonome.
# Name: GenerateNearTable.py # Description: Finds 3 nearest in the near feature class from the input feature class. # Author: ESRI # import system modules import arcpy from arcpy import env # set workspace environment env.workspace = "C:/data/input/gnt.gdb" # set required parameters inFeatures = "campsites" nearFeatures = ["parks", "trails"] outTable = "near_parks_trails" # optional parameters searchRadius = '1500 Meters' location = 'NO_LOCATION' angle = 'NO_ANGLE' closest = 'ALL' closestCount = 3 # find crime locations within the search radius arcpy.GenerateNearTable_analysis(inFeatures, nearFeatures, outTable, searchRadius, location, angle, closest, closestCount)