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



NNAAMMEE
       vv..pprruunnee	- Prunes points from binary GRASS vector data files.
       _(_G_R_A_S_S _V_e_c_t_o_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..pprruunnee
       vv..pprruunnee hheellpp
       vv..pprruunnee [--ii] iinnppuutt==_n_a_m_e oouuttppuutt==_n_a_m_e tthhrreesshh==_v_a_l_u_e

DDEESSCCRRIIPPTTIIOONN
       The GRASS program _v_._p_r_u_n_e allows the user to remove extra points from a
       vector file.  This allows users to reduce disk space required by a vec-
       tor file and still have data accuracy within a given tolerance.

OOPPTTIIOONNSS
   FFllaagg::
       --ii     The  pruning  threshold value is specified in map inches, rather
	      than in data base units on the ground.


   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      Name of binary GRASS vector file containing data to be pruned.

       oouuttppuutt==_n_a_m_e
	      Name to be assigned to new, pruned vector output file.

       tthhrreesshh==_v_a_l_u_e
	      Threshold value used for pruning.

       The program will be run non-interactively if  the  user	specifies  all
       parameters  and (optionally) the _-_i flag on the command line, using the
       form: vv..pprruunnee [--ii] iinnppuutt==_n_a_m_e oouuttppuutt==_n_a_m_e tthhrreesshh==_v_a_l_u_e

       If the user simply types vv..pprruunnee without specifying  program  arguments
       on  the command line, the program will prompt the user to enter parame-
       ter values.

NNOOTTEESS
       The threshold value is the same as the _v_._d_i_g_i_t pruning threshold.  This
       is  specified  in data base units on the ground (e.g., in ground meters
       for UTM data bases).  The threshold can also be specified in inches  on
       the  map,  and the program will convert these to data base ground units
       using the _s_c_a_l_e in the vector file.  If you specify the	scale  in  map
       inches  rather  than  in ground units, you must specify that inches are
       used by setting the _-_i flag.  The input vector data layer will be  read
       and  the resultant pruned vector data layer will be placed into a newly
       created output file whose name is specified by the  user,  leaving  the
       original vector map unchanged.


       The pruning algorithm throws away redundant points within the specified
       threshold.  It works on each vector separately, working	from  node  to
       node.  It does not change the position or number of nodes.

SSEEEE AALLSSOO
       _v_._i_n_._a_s_c_i_i_, _v_._c_l_e_a_n_, _v_._d_i_g_i_t_, _v_._p_r_u_n_e_, _v_._r_m_d_u_p_, _v_._s_p_a_g_, _v_._s_u_p_p_o_r_t


AAUUTTHHOORR
       Dave Gerdes, U.S.Army Construction Engineering Research Laboratory

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_5 _$



GRASS 5.0							    v.prune(1)
