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 vec-
       tor 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 separate _d_i_g (or _d_i_g___a_s_c_i_i) layer.  For
       each DXF layer containing text, a _d_i_g___a_t_t file is also created.	 These
       output  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  for-
       mat;  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  vec-
	      tor format.

	      Name(s)  of layer(s) in the DXF input file containing 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  containing  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  out-
       put  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  con-
       taining 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 intermediate 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 different 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  pprreeffiixx==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  per-
       mit.   Excess characters are truncated.	To minimize the possibility of
       creating 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 majority of characters available for differ-
       entiating between layer names.


       TTrraannssllaattiioonn::
       This  data translation program does not contain any of the quality con-
       trol 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 commands.  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  contour  line   labels).
       Attributes are not attached to converted DXF line data.	For each layer
       of text data in the DXF design file, _v_._i_n_._d_x_f generates a  vector  file
       consisting  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 Lab-
       oratory (12/89)


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


       Code for arcs and circles from National Park Service GIS Division writ-
       ten 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)
