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 interac-
       tively  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 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

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)
