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



NNAAMMEE
       vv..aallaabbeell   -  Bulk-labels  unlabeled  area  features  in a
       binary GRASS vector file.
       _(_G_R_A_S_S _V_e_c_t_o_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..aallaabbeell
       vv..aallaabbeell hheellpp
       vv..aallaabbeell [--ii] mmaapp==_n_a_m_e [vvaalluuee==_v_a_l_u_e] [llaabbeell==_v_a_l_u_e]



DDEESSCCRRIIPPTTIIOONN
       _v_._a_l_a_b_e_l _a_l_l_o_w_s _t_h_e _u_s_e_r _t_o _b_u_l_k_-_l_a_b_e_l _c_u_r_r_e_n_t_l_y _u_n_l_a_b_e_l_e_d
       _p_o_l_y_g_o_n_s  (area	features)  in  a binary GRASS vector file
       (i.e., a _d_i_g file).  The user must run  _v_._s_u_p_p_o_r_t  on  the
       vector  file  before running _v_._a_l_a_b_e_l if any modifications
       have been made to the file since the last  time	_v_._s_u_p_p_o_r_t
       was  run on it, to ensure that all area features are prop-
       erly identified in the file topology.


       The user must also run _v_._s_u_p_p_o_r_t on the vector file  after
       _v_._a_l_a_b_e_l is run for labeling changes to be made evident.


       _v_._s_u_p_p_o_r_t  builds  GRASS  support files for (binary) GRASS
       vector data files.  These support  files  supply  topology
       (_d_i_g___p_l_u_s)  and	category  (_d_i_g___a_t_t, _d_i_g___c_a_t_s) 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.).

OOPPTTIIOONNSS
       Program	parameters and flags have the following meanings.

   FFllaaggss::
       --ii     Label areas incrementally.  For each unique,  unla-
	      beled  polygon  in  the  vector file, increment the
	      category value by one, starting  from  the  initial
	      user-assigned _v_a_l_u_e.


   PPaarraammeetteerrss::
       mmaapp==_n_a_m_e
	      Name  of	binary GRASS vector data file whose unla-
	      beled areas are to be  labelled.	 This  map  layer
	      must exist in the user's current GRASS mapset.

       vvaalluuee==_v_a_l_u_e
	      The  category value to be assigned to all unlabeled
	      areas in the vector map layer.  If the _-_i  flag  is
	      set,  _v_._a_l_a_b_e_l  will increment the initial _v_a_l_u_e by
	      one for each unique unlabeled polygon in the vector
	      map.
	      Default:	1

       llaabbeell==_v_a_l_u_e
	      The  category label to be assigned to all unlabeled
	      areas in the vector map layer.  If  not  specified,
	      each category added will have an empty label in the
	      _d_i_g___c_a_t_s file.



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


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

NNOOTTEESS
       A  _d_i_g___p_l_u_s  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.


       The user can  bulk-label  unlabeled  line  features  in	a
       binary vector file using _v_._d_i_g_i_t.

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_._s_u_p_p_o_r_t

       _v_._t_o_._r_a_s_t

AAUUTTHHOORRSS
       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_3_/_0_3 _1_8_:_5_0_:_5_0 _$



GRASS 5.0					      v.alabel(1)
