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 vector 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  pro-
       gram  arguments	on  the  command  line,  the program will
       prompt the user to enter parameter 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 cre-
       ated 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  sepa-
       rately, 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)
