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



NNAAMMEE
       vv..ssuuppppoorrtt   -  Creates  GRASS  support  files for (binary) GRASS vector
       data.
       _(_G_R_A_S_S _V_e_c_t_o_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..ssuuppppoorrtt
       vv..ssuuppppoorrtt hheellpp
       vv..ssuuppppoorrtt [--sspprr] mmaapp==_n_a_m_e [ooppttiioonn==_n_a_m_e] [tthhrreesshhoolldd==_v_a_l_u_e] [eerrrr==_n_a_m_e]



DDEESSCCRRIIPPTTIIOONN
       _v_._s_u_p_p_o_r_t builds GRASS support files for  (binary)  GRASS  vector  data
       files.	These  support	files  supply topology (dig_plus) and category
       (dig_att) information that are needed by other GRASS programs (e.g., by
       _v_._d_i_g_i_t, _v_._t_o_._r_a_s_t, etc.).


       The program gives the user the options of:

	       building  topological information (the dig_plus file) needed by
	      _v_._d_i_g_i_t for the vector data file, and/or

	       editing the category label (dig_cats) file associated with  the
	      vector data file.


OOPPTTIIOONNSS
       Program parameters and flags have the following meanings.

   FFllaaggss::
       --ss     Snap nodes.  Valid only with _b_u_i_l_d option.

       --pp     Prompt  user for threshold value.  Valid only with _b_u_i_l_d option.
	      This flag is designed to be used only by the  _v_._i_m_p_o_r_t  program,
	      and can usually be ignore.

       --rr     Reset corners of map region from range of data values.


   PPaarraammeetteerrss::
       mmaapp==_n_a_m_e
	      Name  of	binary	GRASS vector data file for which support files
	      are to be created or modified.  This map layer must exist in the
	      user's current GRASS mapset.

       ooppttiioonn==_n_a_m_e
	      Build  topology  information (dig_plus file), or edit categories
	      (dig_att file) for _m_a_p.
	      Options:	_b_u_i_l_d, _e_d_i_t
	      Default:	_e_d_i_t

       tthhrreesshhoolldd==_v_a_l_u_e
	      Snapping threshold value to  be  used  when  building  topology.
	      Specified value is always saved in file header.  (Note: snapping
	      is done only with _b_u_i_l_d option and --ss flag).

       eerrrr==_v_a_l_u_e
	      Name of new vector binary file, where are saved all  area  edges
	      with topology problems like free ends or not closed areas.

       The user can run this program non-interactively by specifying parameter
       values (and optionally, flag settings) on the command line.


       Alternately, the user can simply type the command vv..ssuuppppoorrtt on the com-
       mand  line.   In  this event, the program will prompt the user to enter
       parameter values and flag settings.


       If the _b_u_i_l_d option is chosen, the user	may  further  specify  the  --ss
       flag,  to  snap	nodes in the vector file.  If nodes are to be snapped,
       the user can either:  (1) use the calculated default  threshold	(based
       on  the	scale of vector data); (2) enter the -p flag, causing the pro-
       gram to prompt the user for a snapping threshold value;	or (3) enter a
       specific threshold value on the command line.


       The  spatial  assignment of category values (found in the dig_att file)
       is also performed during building of file topology.


       The _e_d_i_t option allows the user to edit the category labels to be asso-
       ciated  with  the  category  values  attached to the vector data during
       topology building.  These labels, if created, are then used for	raster
       map  layers  derived  from  their  vector counterparts.	The labels are
       placed in the dig_cats directory.

NNOOTTEESS
       A dig_plus file must be created for each imported vector map before  it
       can  be	used  in  post-GRASS 3.0 versions of _d_i_g_i_t (now referred to as
       _v_._d_i_g_i_t).


       Topological information for GRASS vector files can also be built  using
       _o_p_t_i_o_n _4 of the _v_._i_m_p_o_r_t program.


       This  program  will  convert  pre-4.0 version GRASS vector files to 4.0
       format.


       _v_._s_u_p_p_o_r_t creates support files only for binary vector files located in
       the user's current mapset.

SSEEEE AALLSSOO
       _v_._b_u_i_l_d_._p_o_l_y_l_i_n_e_s, _v_._d_i_g_i_t, _v_._i_m_p_o_r_t, _v_._i_n_._a_s_c_i_i, _v_._p_r_u_n_e, _v_._t_o_._r_a_s_t

AAUUTTHHOORRSS
       Dave Gerdes, U.S.Army Construction Engineering Research Laboratory
       Michael Higgins, 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_8_/_2_8 _1_7_:_0_6_:_3_4 _$



GRASS 5.0							  v.support(1)
