Distance entre les points (Analyse)
Récapitulatif
Détermine les distances entre les entités ponctuelles en entrée et tous les points des entités de proximité, dans un rayon de recherche spécifié.
Pour en savoir plus sur le calcul de la proximité dans les outils de géotraitement
Illustration
 |
Utilisation
-
Cet outil crée une table de distances séparant deux ensembles de points. Si le rayon de recherche par défaut est utilisé, les distances à partir de tous les points en entrée vers tous les points de proximité sont calculées. La table en sortie peut être très grande. Par exemple, si les entités en entrée et les entités de proximité comportent 1 000 points chacune, la table en sortie peut contenir un million d'enregistrements.
Utilisez un rayon de recherche significatif pour limiter la taille de la sortie et améliorer les performances de l'outil. La table en sortie contient uniquement les enregistrements qui présentent un point de proximité dans le rayon de recherche.
-
Les résultats sont enregistrés dans la table en sortie contenant les informations suivantes :
- INPUT_FID : ID d'entité des entités en entrée
- NEAR_FID : ID d'entité des entités de proximité
- DISTANCE : Distance de l'entité en entrée à l'entité de proximité La valeur de ce champ est exprimée dans l'unité linéaire du système de coordonnées des entités en entrée.
-
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 ponctuelles de départ du calcul des distances jusqu'aux entités de proximité. | Feature Layer |
near_features |
Points d'arrivée du calcul des distances à partir des entités en entrée. Les distances entre les points compris dans une même couche ou classe d'entités peuvent être déterminées en spécifiant la même couche ou classe d'entités pour les entités en entrée et les entités de proximité. | Feature Layer |
out_table |
Table contenant la liste des entités en entrée et des informations sur toutes les entités de proximité dans le rayon de recherche. Si aucun rayon de recherche n'est spécifié, les distances séparant toutes les entités en entrée et celles de proximité sont calculées. | 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 dans le calcul. Par défaut, l'unité du rayon de recherche correspond aux unités des entités en entrée. Vous pouvez changer les unités. Par défaut, cela n'a aucun impact sur les unités du champ DISTANCE qui est basé sur les unités du système de coordonnées des entités en entrée. | Linear unit |
Exemple de code
Le script de fenêtre interactive Python ci-dessous illustre l'utilisation de la fonction PointDistance en mode immédiat.
import arcpy
arcpy.env.workspace = "C:/data/pointdistance.gdb"
arcpy.PointDistance_analysis("police_stations", "crime_location", "crime_distances")
Le script Python ci-dessous illustre l'utilisation de la fonction PointDistance dans un script autonome.
# Description: Finds distance of each near point from each input point and outputs to a table.
# import system modules
import arcpy
# set workspace environment
arcpy.env.workspace = "C:/data/pointdistance.gdb"
# set variables
in_features = "police_stations"
near_features = "crime_location"
out_table = "crime_distance4"
search_radius = "22000 Feet"
try:
# find crime locations within the search radius
arcpy.PointDistance_analysis(in_features, near_features, out_table, search_radius)
print arcpy.GetMessages(0)
except arcpy.ExecuteError:
print arcpy.GetMessages(2)
except Exception as ex:
print ex.args[0]