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é.

Illustration

Utilisation

• Cet outil crée une matrice de distance entre deux ensembles de points si le rayon de recherche par défaut est utilisé. Dans ce cas, les distances entre toutes les entités en entrée et toutes les entités de proximité sont calculées. La table en sortie peut être très grande. Par exemple, si les ensembles d'entités en entrée et d'entités de proximité comportent 1000 points chacun, la table en sortie peut contenir un million d'enregistrements. Utilisez un rayon de recherche significatif pour limiter la taille de la sortie.

• Les résultats sont enregistrés dans la table en sortie contenant les informations suivantes :

  • INPUT_FID : identifiant d'entité des entités en entrée.
  • NEAR_FID : identifiant d'entité des entités de proximité.
  • DISTANCE : distance de l'entité en entrée à l'entité de proximité.

• 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

PointDistance_analysis (in_features, near_features, out_table, {search_radius})

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 pratiquement toutes les entités de proximité dans le rayon de recherche. Si aucun rayon de recherche n'est spécifié, les distances sont calculées entre toutes les entités en entrée et toutes les entités de proximité.	Table
search_radius (Facultatif)	Les distances sont uniquement calculées pour les entités de proximité situées dans le rayon de recherche des entités en entrée.	Linear unit

Exemple de code

Exemple d'utilisation de l'outil PointDistance 1 (fenêtre Python)

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")

Exemple d'utilisation de l'outil PointDistance 2 (script Python autonome)

Le script Python ci-dessous illustre l'utilisation de la fonction PointDistance dans un script autonome.

# Name: PointDistance.py
# Description: Finds distance of each near point from each input point and outputs to a table.
# Author: ESRI
  
# import system modules
import arcpy
from arcpy import env
  
# set workspace environment
env.workspace = "C:/data/pointdistance.gdb"
  
# set variables
inFeatures = "police_stations"
nearFeatures = "crime_location"
outTable = "crime_distance4"
searchRadius = "22000 Feet"
  
# find crime locations within the search radius
arcpy.PointDistance_analysis(inFeatures, nearFeatures, outTable, searchRadius)

Environnements

Etendue, Espace de travail courant, Espace de travail temporaire

Informations de licence

ArcView : Non

ArcEditor : Non

ArcInfo : Oui