v.distance(1)		      Grass User's Manual		 v.distance(1)



NNAAMMEE
       vv..ddiissttaannccee  - Calculates distance from a point to nearest line or point
       in vector layer.
       _(_G_R_A_S_S _V_e_c_t_o_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..ddiissttaannccee
       vv..ddiissttaannccee hheellpp
       vv..ddiissttaannccee  mmaapp==_n_a_m_e [eeaasstt__nnoorrtthh==_e_a_s_t_,_n_o_r_t_h[,_e_a_s_t_,_n_o_r_t_h,...]

DDEESSCCRRIIPPTTIIOONN
       _v_._d_i_s_t_a_n_c_e uses a binary vector	file  (map=_n_a_m_e)  and  user  specified
       coordinates  to	calculate  the distance from the given point(s) to the
       nearest line or point in vector layer.



   PPaarraammeetteerrss::
       mmaapp==_n_a_m_e
	      Name of a binary vector file.

       eeaasstt__nnoorrtthh==
	      One or multiple coordinate pairs for query



       _v_._d_i_s_t_a_n_c_e can be run either  non-interactively	or  interactively  but
       interactive  user  input  is required to define the points to calculate
       the distance from.

EEXXAAMMPPLLEE
       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 num-
       ber, 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

SSEEEE AALLSSOO
       _r_._d_i_s_t_a_n_c_e

AAUUTTHHOORR
       Janne Soimasuo 1994, Finland

       University of Joensuu, Faculty of Forestry, Finland


       Cmd line coordinates support: Markus Neteler, ITC-irst, Trento, Italy

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_2_/_0_8 _1_3_:_4_6_:_1_2 _$



GRASS 5.0							 v.distance(1)
