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



NNAAMMEE
       vv..llllaabbeell   -  Bulk-labels  unlabeled  points or lines 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..llllaabbeell
       vv..llllaabbeell hheellpp
       vv..llllaabbeell [--iinn] mmaapp==_n_a_m_e [ttyyppee==_n_a_m_e] [vvaalluuee==_v_a_l_u_e] [llaabbeell==_v_a_l_u_e]

DDEESSCCRRIIPPTTIIOONN
       _v_._l_l_a_b_e_l allows the user to bulk-label currently  unlabeled  points  or
       lines  (not  areas)  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_._l_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 lines are properly  identi-
       fied in the file topology.


       The  program  also runs _v_._s_u_p_p_o_r_t on the vector file after labelling so
       that the changes will 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  incrementally.   For each unique, unlabeled line or point
	      in the vector file, increment the category value by one,	start-
	      ing from the initial default or user-assigned _v_a_l_u_e.

       --nn     Do not run _v_._s_u_p_p_o_r_t.  There may occasionally be instances where
	      the user prefers not to run _v_._s_u_p_p_o_r_t immediately.


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

       ttyyppee==_n_a_m_e
	      Select type of primitives to  be	labeled.   Primitives  include
	      points, line arcs, area edge arcs and points.  v.llabel does not
	      label areas.

	      Options: point, edge, line
	      Default:	all

       vvaalluuee==_v_a_l_u_e
	      The category value to be assigned to  all  unlabeled  points  or
	      lines  in the vector map layer.  If the _-_i flag is set, _v_._l_l_a_b_e_l
	      will increment the initial _v_a_l_u_e by one for  each  unique  unla-
	      beled point or line in the vector map.
	      Default:	1

       llaabbeell==_v_a_l_u_e
	      The category label to assign to all unlabeled points or lines in
	      the vector map layer.  If unspecified, all added categories will
	      be given an empty label the 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..llllaabbeell 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 _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_n_._a_s_c_i_i, _v_._s_u_p_p_o_r_t, and _v_._a_l_a_b_e_l

AAUUTTHHOORRSS
       James Darrell McCauley, Agricultural Engineering, Purdue University
       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_4_/_1_3 _1_4_:_3_8_:_2_9 _$



GRASS 5.0							   v.llabel(1)
