Point Distance (Coverage)

License Level:BasicStandardAdvanced

Summary

Computes the point-to-point distance between each point in a coverage to all points in the same or another coverage within a specified search radius.

Illustration

Point Distance illustration

Usage

Syntax

PointDistance_arc (from_cover, to_cover, out_info_table, {search_radius})
ParameterExplanationData Type
from_cover

The point coverage for which distances to another coverage's points are to be computed.

Coverage
to_cover

The point coverage from which point distances are to be measured. Distances between all points in the same coverage can be calculated by specifying the same coverage name for both <from_cover> and <to_cover> arguments.

Coverage
out_info_table

The INFO data table created by Point Distance, which holds the distance measurements. The number of records created in <output Info table:> depends on the search radius used, but it can be as large as the number of points in the <from cover> times the number of points in the <to cover:>.

INFO Table
search_radius
(Optional)

The maximum distance in coverage units a feature can be from the current point for consideration as the closest feature. The default value is the diagonal width of the from coverage’s BND.

Double

Code Sample

PointDistance example (stand-alone script)

The following stand-alone script demonstrates how to calculate the distances between points in two coverages.

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

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: No
ArcGIS for Desktop Advanced: Requires ArcInfo Workstation installed
6/18/2012