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



NNAAMMEE
       vv..eexxppoorrtt   -  Converts  binary vector files into formatted
       ASCII files for transfer to other computer systems.
       _(_S_C_S _G_R_A_S_S _V_e_c_t_o_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..eexxppoorrtt
       vv..eexxppoorrtt hheellpp

DDEESSCCRRIIPPTTIIOONN
       This program performs all of the processes that are needed
       to convert binary vector files into formatted ASCII files.


       It also creates support files:

	- an attribute flat file, which contains information  for
       each area in the
	      DLG file -- i.e., the DLG area  number,  the  GRASS
	      area  label, and the GRASS category code (only cre-
	      ated when exporting in DLG format);

	- an attribute file which contains the	information  from
       the _d_i_g___a_t_t
	      file (only created when exporting ASCII vector for-
	      mat).



       EXPORT FILES
       After  entering	the  command  _v_._e_x_p_o_r_t,  the user will be
       asked which type of file to export:

	Exports from GRASS Vector (_v_._d_i_g_i_t) Format



	1  -	   ASCII DLG file from GRASS Vector Format

	2  -	   ASCII   DIGIT file from GRASS Vector Format

	3  -	   ASCII   SCS-GEF file from GRASS Vector Format

	4  -	   ASCII   ARC/INFO file from GRASS Vector Format

	5  -	   ASCII   DXF file from GRASS Vector Format


       If numbers 1-4 are chosen, _v_._e_x_p_o_r_t will  respond  with	a
       request	for  the vector file name.  After the user enters
       the file name the program proceeds to create  the  respec-
       tive output format files.


       GRASS Vector to DLG File
       Converts  binary  vector  files	(such as those created by
       _v_._d_i_g_i_t) to a DLG file and  creates  the  attribute  file.
       Both  files  are  placed in the _d_l_g directory under a user
       selected name;  the attribute file has .att appended.


       GRASS Vector File into ASCII Vector File
       Converts a binary vector file into a readable ASCII  file.
       Both  files  are  placed int the _d_i_g___a_s_c_i_i directory under
       the same name as the given vector file, the attribute file
       has .att appended.


       GRASS Vector to SCS-GEF File
       Converts  binary  vector  files to SCS-GEF files.  Creates
       the SCS-GEF header, lines, text, and feature  files.   All
       files  are created and placed in a $LOCATION/gef directory
       as a single UNIX file under a user selected name.
       The following is the SCS-GEF file structure:

       header record 1
	  |	 |
       header record n
       -head
       line record 1
	  |	 |
       line record n
       -line
       text record 1
	  |	 |
       text record n
       -text
       feature record 1
	  |	 |
       feature record n
       -feat

       The user will be required to use standard UNIX commands to
       separate  this  file  into individual files as required by
       SCS-GEF specifications.


       GRASS Vector to ARC/INFO(generated) File
       Converts binary vector files to a "ARC ungenerate" format.
       A  GRASS  vector  file  to be exported to ARC/INFO must be
       either a line coverage (must  contain  only  lines)  or	a
       polygon	coverage  (must  contain  only area edges).  Both
       "ungenerate lines and points" files are	created  and  are
       placed  in a $LOCATION/arc directory under a user selected
       name.


       The binary vector name will be used to  name  the  various
       files that will be created for export to ARC/INFO.  In the
       case of a labelled polygon coverage, the  following  three
       files will be created:  a lines file with the suffix .lin,
       a label-points file with the suffix .lab, and a label-text
       file with the suffix .txt.


       In  the	case  of  a line coverage the following two files
       will be created: a lines file with the suffix .lin, and	a
       label-text file with the suffix .txt.


       An  unlabelled  polygon	or line coverage will result in a
       lines file (.lin suffix) only.  See the DATA FILE  FORMATS
       section of v.import for more information on these files.


       GRASS Vector to DXF file
       Converts binary vector files to a "DXF" format.




NNOOTTEESS
       Support files must be built using the GRASS program _v_._s_u_p_-
       _p_o_r_t before exporting any vector file.


       Other ASCII formats are	useful	when  importing/exporting
       data  into  and	from GRASS.  Such data files should be in
       ASCII format when transferred.

SSEEEE AALLSSOO
       _v_._d_i_g_i_t

       _v_._i_m_p_o_r_t _v_._o_u_t_._a_r_c

       _v_._o_u_t_._a_s_c_i_i

       _v_._o_u_t_._d_l_g

       _v_._o_u_t_._d_l_g_._s_c_s

       _v_._o_u_t_._d_x_f

       _v_._o_u_t_._s_c_s_g_e_f

       _v_._s_u_p_p_o_r_t

AAUUTTHHOORR
       R.L. Glenn, USDA, SCS, NHQ-CGIS

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