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 associ-
	      ated 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 val-
	      ues.


   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  speci-
       fying  parameter values (and optionally, flag settings) on
       the command line.


       Alternately, the user can simply type the  command  vv..ssuupp--
       ppoorrtt on the command line.  In this event, the program will
       prompt the user to enter parameter values  and  flag  set-
       tings.


       If  the _b_u_i_l_d option is chosen, the user may further spec-
       ify 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 program 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 associated 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_._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_4_/_0_8 _1_3_:_1_7_:_3_3 _$



GRASS 5.0					     v.support(1)
