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



NNAAMMEE
       vv..aallaabbeell   - Bulk-labels unlabeled area features in a binary GRASS vec-
       tor 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 properly iden-
       tified 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, unlabeled polygon
	      in the vector file, increment the category value by one,	start-
	      ing from the initial user-assigned _v_a_l_u_e.


   PPaarraammeetteerrss::
       mmaapp==_n_a_m_e
	      Name  of binary GRASS vector data file whose unlabeled 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	incre-
	      ment  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 specifying parameter
       values (and optionally, the flag setting) on the command line.


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

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)
