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



NNAAMMEE
       vv..ccaaddllaabbeell - Attaches labels to (binary) vector contour lines that have
       been imported to GRASS from DXF format.
       _(_G_R_A_S_S _V_e_c_t_o_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..ccaaddllaabbeell
       vv..ccaaddllaabbeell hheellpp
       vv..ccaaddllaabbeell lliinneess==_n_a_m_e llaabbeellss==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       _v_._c_a_d_l_a_b_e_l attaches labels to index contour lines by  using  the  index
       contour lines and lables files that have been converted from DXF format
       to GRASS vector format by the _v_._i_n_._d_x_f program.	Users have the	option
       of  creating either binary or ASCII output with _v_._i_n_._d_x_f.  Since _v_._c_a_d_-
       _l_a_b_e_l works only  on  binary  vector  files,  the  ASCII  GRASS	vector
       (dig_ascii)  files  that are generated by _v_._i_n_._d_x_f must be converted to
       binary GRASS vector (dig) files using  the  _v_._i_n_._a_s_c_i_i  program	before
       _v_._c_a_d_l_a_b_e_l can be executed.


       _v_._c_a_d_l_a_b_e_l searches a binary GRASS vector file of contour lines to find
       the contour lines that are closest to each box (contour label)  in  the
       binary  GRASS  vector  file containing contour labels.  The two contour
       lines that are closest to a box are tagged with the same label (an ele-
       vation value) as that of the box.

OOPPTTIIOONNSS
       Program parameters are described below.

   PPaarraammeetteerrss::
       lliinneess==_n_a_m_e
	      Name  of	the  binary GRASS vector (dig) file, imported from DXF
	      format, that contains index contour lines.

       llaabbeellss==_n_a_m_e
	      Name of the binary GRASS vector (dig_att)  file,	imported  from
	      DXF format, that contains index contour line labels.


NNOOTTEESS
       Because	line  data  that  are created in CAD format may have unsnapped
       nodes or gaps, _v_._c_a_d_l_a_b_e_l will not always be able to label every  index
       contour	line.	Also, intermediate contour lines that may be contained
       in the index contour vector file (because they resided on the same  DXF
       level  as  the  index contour lines in the DXF design file) will not be
       labeled.  Any lines that are not labeled with _v_._c_a_d_l_a_b_e_l can be labeled
       with the contour labeling program in _v_._d_i_g_i_t.


       If  the	intermediate  contour  lines are in a separate GRASS dig file,
       they can be patched to an labeled index contour	file  with  the  GRASS
       program _v_._p_a_t_c_h, and then labeled in _v_._d_i_g_i_t.


       The user does not need to _v_._p_a_t_c_h the labels vector file (boxes) to the
       lines vector file (contour lines).  The purpose of  the	labels	vector
       file  is  to determine which labels should be assigned to which contour
       lines (in the lines vector file) during the execution of _v_._c_a_d_l_a_b_e_l.

SSEEEE AALLSSOO
       _v_._d_i_g_i_t

       _v_._i_n_._a_s_c_i_i

       _v_._i_n_._d_x_f

       _v_._o_u_t_._d_x_f

       _v_._p_a_t_c_h

       _d_x_f_o_u_t (Microstation tool)

AAUUTTHHOORR
       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_1_/_2_5 _0_5_:_4_5_:_3_5 _$



GRASS 5.0							 v.cadlabel(1)
