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 pro-
       gram _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 interactively.  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 for-
	      mat.

       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 nam-
       ing 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 coverage) 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 suf-
       fix  .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 suffix .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 suf-
       fix) only. All exported files are stored in the current directory.

       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	corre-
       spond  to  the  GRASS category 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)  coordinates,  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 (contain-
       ing 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)
