Distance entre les points (Analyse)

Synthèse

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

Héritage :

C’est un outil déconseillé. Cette fonctionnalité a été remplacée par les outils Proche et Générer la table de proximité qui calculent désormais les distances entre les entités ponctuelles, polylinéaires et surfaciques.

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 : identifiant 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.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Entités ponctuelles de départ du calcul des distances jusqu'aux entités de proximité.	Feature Layer
Entités de proximité	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
Table en sortie	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
Rayon de recherche (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

Python

arcpy.analysis.PointDistance(in_features, near_features, out_table, {search_radius})

Nom	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

Exemple 1 d'utilisation de l'outil PointDistance (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.analysis.PointDistance("police_stations", "crime_location", "crime_distances")

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

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.analysis.PointDistance(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]

Environnements

Étendue, Espace de travail courant, Espace de travail temporaire

Informations de licence

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