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 con-
       taining contour labels.	The two contour  lines	that  are
       closest to a box are tagged with the same label (an eleva-
       tion 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 con-
	      tour lines.

       llaabbeellss==_n_a_m_e
	      Name of the binary  GRASS  vector  (dig_att)  file,
	      imported	from DXF format, that contains index con-
	      tour 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,  intermedi-
       ate  contour lines that may be contained in the index con-
       tour 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 pro-
       gram 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)
