NAME
v.distance - Calculates distance from a point to nearest line or point in vector layer.
(GRASS Vector Program)
SYNOPSIS
v.distance
v.distance help
v.distance map=name
[east_north=east,north[,east,north,...]
DESCRIPTION
v.distance
uses a binary vector file (map=name) and user specified
coordinates to calculate the distance from the given point(s) to
the nearest line or point in vector layer.
Parameters:
- map=name
- Name of a binary vector file.
- east_north=
- One or multiple coordinate pairs for query
v.distance can be run either non-interactively or interactively
but interactive user input is required to define the points to calculate
the distance from.
EXAMPLE
To calculate the distance of given sites to the next road, run:
s.out.ascii -d archsites | v.distance roads
To calculate the distance of given sites to the next road and store the list
as new sites map with distance attribute and vector attribute number, run:
s.out.ascii -d archsites | v.distance roads | s.in.ascii fs='|' sites=dist
The output structure is:
E|N|sitesID|dist|vect_line_ATT
e.g.
1680949.350649|5100196.753247|31|16.854858|22002
SEE ALSO
r.distance
AUTHOR
Janne Soimasuo 1994, Finland
University of Joensuu, Faculty of Forestry, Finland
Cmd line coordinates support: Markus Neteler, ITC-irst, Trento, Italy
Last changed: $Date$