v.out.arc(1)	       Grass User's Manual	     v.out.arc(1)



NNAAMMEE
       vv..oouutt..aarrcc   -  Exports  GRASS  vector  files to ARC/INFO's
       "ungenerate" file format.
       _(_G_R_A_S_S _V_e_c_t_o_r _D_a_t_a _E_x_p_o_r_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..oouutt..aarrcc
       vv..oouutt..aarrcc hheellpp
       vv..oouutt..aarrcc ttyyppee==_n_a_m_e vveecctt==_n_a_m_e aarrcc__pprreeffiixx==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       _v_._o_u_t_._a_r_c is a GRASS data  export  program  that  converts
       files in GRASS vector format to ARC/INFO's "Generate" file
       format.	The companion program _v_._i_n_._a_r_c

       imports data in ARC/INFO's "Generate" format and  converts
       them to GRASS vector format.


       This program can be run either non-interactively or inter-
       actively.  The program will be  run  non-interactively  if
       the  user  specifies  parameter values on the command line
       using the following format:


       vv..oouutt..aarrcc ttyyppee==_n_a_m_e vveecctt==_n_a_m_e aarrcc__pprreeffiixx==_n_a_m_e



       Alternately, the user can simply type:


       vv..oouutt..aarrcc



       on the command line;   in  this	case,  the  program  will
       prompt the user for parameter values.





   PPaarraammeetteerrss::
       ttyyppee==_n_a_m_e
	      Coverage (feature) type.
	      Options:	polygon, line

       vveecctt==_n_a_m_e
	      The  name of a GRASS vector file to be converted to
	      ARC/INFO format.

       aarrcc__pprreeffiixx==_n_a_m_e
	      A prefix to  be  assigned  to  the  ARC/INFO-format
	      files output by _v_._o_u_t_._a_r_c.






IINNTTEERRAACCTTIIVVEE MMOODDEE:: UUSSEERR PPRROOMMPPTTSS
       _v_._o_u_t_._a_r_c  will	prompt	the  user  to enter the name of a
       GRASS vector file to be exported to  ARC/INFO  and  for	a
       filename  prefix to be used in naming the files created by
       the program.


       A GRASS vector file to be exported to ARC/INFO must either
       contain	only linear features (i.e., have only line cover-
       age) or contain only area edge features (i.e.,  have  only
       polygon	coverage).   _v_._o_u_t_._a_r_c	will  begin by asking the
       user which type of coverage (line or  polygon)  is  to  be
       imported:

	    COVERAGE TYPE
	    Enter "polygon" or "line"
	    Hit RETURN to cancel request
	    >

       The  program  then  prompts  the  user for the name of the
       GRASS vector file to be converted to ARC/INFO format:

	    VECTOR (DIGIT) FILENAME
	    Enter 'list' for a list  of  existing  binary  vector
       files
	    Hit RETURN to cancel request
	    >

       Next,  the user is asked for a file-name prefix to be used
       in naming the output ARC/INFO Generate format files:

	    ARC/INFO (GENERATE) FILENAME PREFIX
	    Hit RETURN to cancel request
	    >

       The filename prefix will be used to name the various files
       that will be created for export to ARC/INFO.  When labeled
       polygon coverage data are exported, three such files  will
       be  created:   a _l_i_n_e_s _f_i_l_e with the suffix .lin, a _l_a_b_e_l_-
       _p_o_i_n_t_s _f_i_l_e with the suffix .lab, and  a  _l_a_b_e_l_-_t_e_x_t  _f_i_l_e
       with  the  suffix  .txt.   When	line  coverage	data  are
       exported, two such files will be  created:  a  _l_i_n_e_s  _f_i_l_e
       with  the suffix .lin, and a _l_a_b_e_l_-_t_e_x_t _f_i_l_e with the suf-
       fix .txt.  Export of unlabeled polygon  or  line  coverage
       data will result in creation of a _l_i_n_e_s _f_i_l_e (.lin suffix)
       only. All exported files are stored in the current  direc-
       tory.

       See  the DATA FILE FORMATS section for more information on
       these files.





EEXXAAMMPPLLEE
       Linear features and polygon data are made up of the series
       of  arcs  (aka,	vectors) outlining their perimeters.  The
       _A_R_C_/_I_N_F_O _U_s_e_r_s_' _G_u_i_d_e, in its discussion of the _U_n_g_e_n_e_r_a_t_e
       command,  explains  how line and polygon coverage data can
       be created from files  (like  _p_r_e_f_i_x_._l_i_n  and  _p_r_e_f_i_x_._p_o_l)
       containing  the	geographic coordinates of these arcs, and
       from files (like  _p_r_e_f_i_x_._l_a_b)  containing  the  geographic
       coordinates  of	label-points.	Below is an example which
       illustrates the creation, within ARC/INFO,  of  a  polygon
       coverage  data file (named _s_o_i_l_s) from the files _s_o_i_l_s_._p_o_l
       and _s_o_i_l_s_._l_a_b.

	  Arc: GENERATE SOILS
	  Generate: INPUT soils.pol
	  Generate: LINES
	  Generating lines ...
	  Generate: INPUT soils.lab
	  Generate: POINTS
	  Generating points ...
	  Generate: QUIT
	  Arc: _

       The above example would create  a  polygon  coverage  data
       file  named  _s_o_i_l_s  with  label-points.	 The label-points
       would have ID numbers that correspond to the  GRASS  cate-
       gory  values  for  the polygons in the coverage.  The INFO
       portion of ARC/INFO can be used to associate these  label-
       point  ID numbers with descriptive text from the _s_o_i_l_s_._t_x_t
       file.



DDAATTAA FFIILLEE FFOORRMMAATTSS
       LINES FILE, also know as _p_r_e_f_i_x_._l_i_n or _p_r_e_f_i_x_._p_o_l file:
       This text file is a "Generate"  format  lines  file.   The
       _l_i_n_e_s  option of the ARC/INFO _G_e_n_e_r_a_t_e command can be used
       to read this file into ARC/INFO.  Each line  in	the  file
       has a unique line-ID number.

       101
       223343.62 218923.15
       223343.62 222271.06
       259565.31 222271.06
       259565.31 195577.37
       END
       102
       237862.53 203392.37
       244970.75 203744.28
       253137.66 195577.37
       259565.31 195577.37
       END
       103
       237862.53 203392.37
       237862.53 203744.28
       223343.62 218392.37
       END
       104
       239072.44 186200.56
       237862.53 187410.50
       237862.53 203392.37
       END
       END

       LABEL-POINTS FILE, also known as _p_r_e_f_i_x_._l_a_b file:
       This  text file will be created by _v_._o_u_t_._a_r_c if the vector
       file being exported represents a polygon  coverage.   _p_r_e_-
       _f_i_x_._l_a_b	consists  of  a list of label-point (x,y) coordi-
       nates, each with a unique label-point ID number.

       1 242777.81 211533.09
       2 243458.37 199282.28
       3 243458.37 195199.28

       LABEL-TEXT FILE, also known as _p_r_e_f_i_x_._t_x_t file:
       In the case of polygon coverage data, this file associates
       an   integer   category	 value	 and   a  category  label
       ("attribute") text string (containing no spaces) with each
       label-point ID number.  In the case of line coverage data,
       this file associates an	integer  category  value  and  an
       attribute text string with each line-ID number.


       The  first  column is the row number (which is arbitrary),
       the second column contains the category value,  the  third
       column  holds  the  line or label-point ID number, and the
       fourth column contains the attribute text string.

       1 4 1 Coniferous
       2 5 2 Deciduous
       3 2 3 Rangeland


SSEEEE AALLSSOO
       _v_._i_n_._a_r_c



       _v_._s_u_p_p_o_r_t


AAUUTTHHOORR
       Dave Johnson

       DBA Systems, Inc.

       10560 Arrowhead Drive

       Fairfax, Virginia 22030

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