v.in.dxf(1)	       Grass User's Manual	      v.in.dxf(1)



NNAAMMEE
       vv..iinn..ddxxff   -  Converts  files  in  DXF  format to ASCII or
       binary GRASS vector file format.
       _(_G_R_A_S_S _V_e_c_t_o_r _D_a_t_a _I_m_p_o_r_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..iinn..ddxxff
       vv..iinn..ddxxff hheellpp
       vv..iinn..ddxxff   [    --aa]    ddxxff==_n_a_m_e	  [lliinneess==_n_a_m_e[,_n_a_m_e,...]]
       [llaabbeellss==_n_a_m_e[,_n_a_m_e,...]] [pprreeffiixx==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       The  _v_._i_n_._d_x_f data conversion program generates GRASS _d_i_g,
       _d_i_g___a_s_c_i_i, and _d_i_g___a_t_t files from a file  in  DXF  format.
       Each  layer  in the DXF input file is converted to a sepa-
       rate _d_i_g (or _d_i_g___a_s_c_i_i) layer.  For each  DXF  layer  con-
       taining	text, a _d_i_g___a_t_t file is also created.  These out-
       put files are placed in the _d_i_g,  _d_i_g___a_s_c_i_i,  and  _d_i_g___a_t_t
       directories under the user's current GRASS mapset.


       Output  from  this program is designed to be used as input
       to the program _v_._c_a_d_l_a_b_e_l.


       The _v_._i_n_._d_x_f program will only  recognize  points,  lines,
       polylines,  and text in the DXF format, and will translate
       these to GRASS vector format;  other  types  of	data  are
       ignored.





   FFllaaggss::
       --aa     Output  an  ASCII  GRASS	vector	(_d_i_g___a_s_c_i_i)  file
	      rather than a binary GRASS vector (_d_i_g) file.






   PPaarraammeetteerrss::
       ddxxff==_n_a_m_e
	      Name of the DXF input design file to  be	converted
	      to GRASS vector format.

	      Name(s)  of layer(s) in the DXF input file contain-
	      ing line data, and (optionally) the name(s)  to  be
	      assigned	 to   the   GRASS  vector  data  (_d_i_g  or
	      _d_i_g___a_s_c_i_i) files output.
	      Default:	Convert each layer containing data in the
	      Idxf file to a GRASS vector data (_d_i_g or _d_i_g___a_s_c_i_i)
	      file.

	      Name(s) of layer(s) in the DXF input file  contain-
	      ing text labels, and (optionally) the name(s) to be
	      assigned to the GRASS  vector  attribute	(_d_i_g___a_t_t)
	      files output.
	      Default:	Convert each layer containing text labels
	      in  the  _d_x_f  map  to  a	GRASS  vector	attribute
	      (_d_i_g___a_t_t) file.

       pprreeffiixx==_n_a_m_e
	      Prefix assigned to the _d_i_g or _d_i_g___a_s_c_i_i and _d_i_g___a_t_t
	      output file names.


       The  names  of  the  GRASS  vector  (_d_i_g,  _d_i_g___a_s_c_i_i,  and
       _d_i_g___a_t_t) files output are constructed as _p_r_e_f_i_x_._e_x_t_e_n_s_i_o_n,
       where _p_r_e_f_i_x is the _p_r_e_f_i_x name specified by the user  and
       _e_x_t_e_n_s_i_o_n  is  the  number of the DXF layer from which the
       data were obtained.  If the user does not specify a _p_r_e_f_i_x
       name,  the  output files take their prefix from the prefix
       of the input DXF map layer.  For example, for the DXF file
       named  _s_t_r_e_a_m_s_._d_x_f  containing  line  data  on layer , the
       GRASS vector map layer output would be named _s_t_r_e_a_m_s_..


EEXXAAMMPPLLEESS
       lliinneess==1155
	      Outputs line data in DXF layer 15.

       lliinneess==1155,,1166
	      Outputs line data in DXF layers 15 and 16.

       lliinneess==RROOAADDSS,,WWAATTEERR
	      Converts line data in DXF layers ROADS and WATER.

       lliinneess==1155::1166
	      Outputs line data in DXF layer 15, and places it in
	      the _d_i_g (or _d_i_g___a_s_c_i_i) file for DXF layer 16.






       The  below  examples are given for a DXF design file named
       _c_o_n_t_._d_x_f containing contour lines and contour line labels,
       in which:


       index contour lines are in DXF layer 9,
       intermediate contour lines are in DXF layer 11, and
       index  labels  and  some intermediate contour lines are in
       DXF layer 12.







       _v_._i_n_._d_x_f can be run with default values, as shown below:


       vv..iinn..ddxxff  ddxxff==cont.dxf





       Here, this is equivalent to running the following command:


       vv..iinn..ddxxff  ddxxff=cont.dxf  lliinneess==9,11,12  llaabbeellss==12





       Either  of the above commands will produce three GRASS _d_i_g
       files (named _c_o_n_t_._9_, _c_o_n_t_._1_1, and _c_o_n_t_._1_2) and one _d_i_g___a_t_t
       file (named _c_o_n_t_._1_2).


       In  our example, however, the _c_o_n_t_._1_2 file contains inter-
       mediate contour lines that the user would like to  add  to
       the  _d_i_g file _c_o_n_t_._1_1.  Our user also wishes to use a dif-
       ferent file prefix than the default prefix _c_o_n_t.  The user
       therefore types the following command:


       vv..iinn..ddxxff   ddxxff==cont.dxf	lliinneess==9,11,12:11  llaabbeellss==12  pprree--
       ffiixx==contour





       The above command will generate	three  _d_i_g  files  (named
       _c_o_n_t_o_u_r_._9_,  _c_o_n_t_o_u_r_._1_1_,	_c_o_n_t_o_u_r_._1_2),  and will create one
       _d_i_g___a_t_t file containing text labels  (called  _c_o_n_t_o_u_r_._1_2).
       No contour lines will appear in the _d_i_g___a_t_t file.

NNOOTTEESS
       OOuuttppuutt FFiilleennaammeess::
       The  output  filename, _p_r_e_f_i_x_._e_x_t_e_n_s_i_o_n, conforms with the
       GRASS limit of 14 characters.  The entire prefix  name  is
       used, a '.' inserted, and as much of the extension name is
       used as the 14 character limit will permit.  Excess  char-
       acters are truncated.  To minimize the possibility of cre-
       ating output files with the same names (resulting in  loss
       of  data  from  the  DXF  file),  use the prefix option to
       abbreviate the DXF file name.  This will leave the  major-
       ity  of	characters  available for differentiating between
       layer names.


       TTrraannssllaattiioonn::
       This data translation program does not contain any of  the
       quality	control  functions available in _v_._d_i_g_i_t that will
       prevent data in an improper format from being input  to	a
       GRASS  data  base.  If present, DXF entities are placed in
       output file(s) corresponding to the layers on  which  they
       occurred in the DXF design file input.


       EEddiittiinngg::
       If   the   user	asks  _v_._i_n_._d_x_f	to  output  ASCII  vector
       (_d_i_g___a_s_c_i_i) files, they must be converted to binary vector
       format  before  they  are usable by most GRASS vector com-
       mands.  The user can convert GRASS vector files from ASCII
       to  binary format by running such programs as _v_._s_u_p_p_o_r_t or
       _v_._i_n_._a_s_c_i_i.  After conversion to binary format the  vector
       files  can be displayed (e.g., with _d_._v_e_c_t);  however, the
       user must run _v_._s_u_p_p_o_r_t on the binary vector files  before
       they  can  be  edited  in  _v_._d_i_g_i_t.   The  files output by
       _v_._i_n_._d_x_f will preserve the  data  in  whatever  form  they
       exist  in  the DXF file.  This means that output files may
       contain unsnapped nodes, overshoots, gaps, and  replicated
       lines.	 The   data,  and  the	file  header  information
       (including the owner's name, map's name, date, and  scale,
       and  UTM  zone)	for  the  GRASS  vector  files output may
       require editing by the user in _v_._d_i_g_i_t.


       AAttttrriibbuutteess::
       The _v_._i_n_._d_x_f program attaches attributes only to DXF  text
       data that are converted to GRASS vector data (such as con-
       tour line labels).  Attributes are not  attached  to  con-
       verted  DXF line data.  For each layer of text data in the
       DXF design file, _v_._i_n_._d_x_f generates a vector file consist-
       ing of rectangular boxes (lines) that are drawn around the
       DXF text data, and uses the text values to create a  GRASS
       attribute  file	for  the boxes.  The vector and attribute
       files can then be used to label	contour  lines	with  the
       _v_._c_a_d_l_a_b_e_l program.

SSEEEE AALLSSOO
       _v_._c_a_d_l_a_b_e_l, _v_._d_i_g_i_t, _v_._i_n_._a_s_c_i_i, _v_._o_u_t_._d_x_f, _v_._s_u_p_p_o_r_t

AAUUTTHHOORRSS
       Original _d_x_f_2_d_i_g program written by Jan Moorman, U.S. Army
       Construction Engineering Research Laboratory (6/89)


       Revised by Dave Gerdes, U.S. Army Construction Engineering
       Reseach Laboratory (12/89)


       Revised	and  appended by Jan Moorman, U.S. Army Construc-
       tion Engineering Research Laboratory (7/90)


       Code for arcs and circles from National Park  Service  GIS
       Division written by Tom Howard.

       _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.in.dxf(1)
