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 iden-
       tified 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, starting 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  unla-
	      beled  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.   Primi-
	      tives 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 unlabeled 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 speci-
       fying parameter values (and optionally, the flag  setting)
       on the command line.


       Alternately, the user can simply type the command vv..llllaabbeell
       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 _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)
