Disponible avec une licence Advanced.
Résumé
Calcule la distance point à point entre chaque point d'une couverture et tous les points de la même couverture ou d'une autre couverture, dans un rayon de recherche spécifié.
Illustration
Utilisation
La définition de l'attribut de distance dans le fichier INFO en sortie correspond à la précision maximale des entrées des deux couvertures de points.
Le rayon de recherche équivaut à la distance maximale, en unités de couverture, qui sépare une entité du point courant pour être prise en compte. La largeur diagonale de la limite (BND) de la couverture de départ sert de valeur par défaut si aucun rayon de recherche n'est spécifié.
La distance est égale à zéro si aucune correspondance n'est trouvée dans le rayon de recherche pour un point particulier. Si aucun point n'est trouvé, l'outil envoie un avertissement, et aucune table d'info en sortie n'est créée.
L'outil Distance entre les points ne fonctionne pas si une couverture contient plus de 130 000 points.
La table Info en sortie peut devenir très importante lorsque les couvertures contiennent beaucoup de points. Utilisez un plus petit rayon de recherche pour limiter le nombre de combinaisons.
Si l'option Distance entre les points sert à calculer la distance entre d'autres points dans une couverture unique, les lettres A et B sont ajoutées au nom d'attribut dans le numéro de couverture.
Les fichiers de projection sont comparés pour en évaluer la ressemblance à l'aide du niveau de comparaison spécifié dans les paramètres de l'environnement Comparer les projections. Pour plus d'informations, voir Comparer les projections.
Les résultats sont enregistrés dans une table en sortie qui contient des attributs pour les numéros internes et la distance. L'entrée associée à la précision maximale pour la distance est utilisée pour le champ de distance de la table d'INFO en sortie.
COLUMN ITEM NAME WIDTH OUTPUT TYPE N.DEC 1 <From coverage># 4 6 B - 5 <To coverage># 4 6 B - 9 DISTANCE 4 12 F 3 (single precision) Or 9 DISTANCE 8 18 F 5 (double precision)
Syntaxe
arcpy.arc.PointDistance(from_cover, to_cover, out_info_table, {search_radius})| Paramètre | Explication | Type de données |
from_cover | Couverture de points pour laquelle les distances entre les points d'une autre couverture doivent être calculées. | Coverage |
to_cover | Couverture de points à partir de laquelle les distances entre les points doivent être mesurées. Les distances entre tous les points de la même couverture peuvent être calculées en spécifiant le même nom de couverture pour les arguments Depuis une couverture et Vers une couverture. | Coverage |
out_info_table | Table de données INFO créée par l'outil Distance entre les points qui contient les mesures de distance. Le nombre d'enregistrements créés dans la table Info en sortie dépend du rayon de recherche utilisé. Ce nombre peut être aussi grand que le nombre de points saisi dans l'argument Depuis une couverture multiplié par le nombre de points saisi dans l'argument Vers une couverture. | INFO Table |
search_radius (Facultatif) | Distance maximale, en unités de couverture, qui sépare une entité du point courant pour pouvoir être considérée comme étant l'entité la plus proche. La valeur par défaut est la largeur diagonale de la limite (BND) de la couverture de départ. | Double |
Exemple de code
Exemple d'utilisation de l'outil Distance entre les points (script autonome)
Le script autonome suivant montre comment calculer les distances entre des points dans deux couvertures.
# Name: PointDistance_Example.py
# Description: Calculates the distances between the points in two coverages
# Requirements: ArcInfo Workstation
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
fromCover = "wells"
toCover = "trees"
outInfoTable = "C:/output/distance"
# Execute PointDistance
arcpy.PointDistance_arc(fromCover, toCover, outInfoTable, "")
Environnements
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Requiert ArcInfo Workstation installé