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



NNAAMMEE
       vv..iinn..aarrcc   -  Imports  vector  data in ARC/INFO ungenerate
       format into GRASS.
       _(_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..aarrcc
       vv..iinn..aarrcc hheellpp
       vv..iinn..aarrcc  [--nn]  ttyyppee==_n_a_m_e  lliinneess__iinn==_n_a_m_e  [ppooiinnttss__iinn==_n_a_m_e]
       [tteexxtt__iinn==_n_a_m_e]	 vveeccttoorr__oouutt==_n_a_m_e    [iiddccooll==_v_a_l_u_e]   [ccaatt--
       ccooll==_v_a_l_u_e] [aattttccooll==_v_a_l_u_e]

DDEESSCCRRIIPPTTIIOONN
       The user may wish to use GRASS programs on data files that
       were  created  by  other  GISs.	To do this, the user must
       first convert data files  in  these  systems'  formats  to
       GRASS's	file  format.	Bringing  data from other systems
       into GRASS is termed  file  _i_m_p_o_r_t.   Sending  GRASS  data
       files  out  into  other	systems'  formats  is termed file
       _e_x_p_o_r_t.


       A variety of GRASS programs exist  to  import  and  export
       data to and from GRASS.	The _v_._i_n_._a_r_c program will convert
       vector data in ARC/INFO's  "Generate"  format  to  GRASS's
       vector  file  format, and bring it into the user's current
       GRASS mapset.  The files to  be	imported  to  GRASS  must
       first  have been exported from ARC/INFO using the ARC/INFO
       _U_n_g_e_n_e_r_a_t_e command, and may represent either  linear  fea-
       tures ("line coverage") or areal features ("polygon cover-
       age").  The _A_R_C_/_I_N_F_O _U_s_e_r_'_s _G_u_i_d_e describes how files con-
       taining linear and polygonal features can be exported from
       ARC/INFO, in a section detailing the use of the _U_n_g_e_n_e_r_a_t_e
       command.


       NNoottee  11::  The ARC coverage must be set to single precision
       before running _U_n_g_e_n_e_r_a_t_e.  If it is not, first copy it to
       another coverage that is set to single precision, then run
       _U_n_g_e_n_e_r_a_t_e.


       NNoottee 22::	To use for text attributes, numeric  fields  with
       values  >999  may  contain  no  commas or TABs.	Also, the
       first record must have all fields filled.

OOPPTTIIOONNSS
       Program parameters and the flag have the  following  mean-
       ings.



   FFllaaggss::
       --nn     Neatline.   Vectors  representing  a box (neatline)
	      around the input vector data will be inserted  into
	      the output GRASS vector file.




   PPaarraammeetteerrss::
       ttyyppee==_n_a_m_e
	      Coverage type.  Either polygon, or line.
	      Options:	polygon, line

       lliinneess__iinn==_n_a_m_e
	      ARC/INFO	ungenerate  lines file; ungenerate format
	      input file containing line or polygon  coordinates.

       ppooiinnttss__iinn==_n_a_m_e
	      ARC/INFO	ungenerate  label-points file; ungenerate
	      format input file  containing  label-point  coordi-
	      nates; only applies to 'polygon' type data.

       tteexxtt__iinn==_n_a_m_e
	      ARC/INFO	ungenerate  label-text	file;  ungenerate
	      format input file containing category  numbers  and
	      (optionally) attribute text.

       vveeccttoorr__oouutt==_n_a_m_e
	      Resultant GRASS vector output file.

       iiddccooll==_v_a_l_u_e
	      ID  Number  column  in  label-text file.	Number of
	      label-text column containing line-ID numbers.

       ccaattccooll==_v_a_l_u_e
	      GRASS category column in label-text  file.   Number
	      of label-text column containing category values.

       aattttccooll==_v_a_l_u_e
	      GRASS  attribute column in label-text file.  Number
	      of label-text column containing attribute text.



       This program can be run either non-interactively or inter-
       actively.   The	program will run non-interactively if the
       user specifies the  (optional)  flag  setting  and  needed
       parameter values on the command line, using the form:


       vv..iinn..aarrcc  [--nn]  ttyyppee==_n_a_m_e  lliinneess__iinn==_n_a_m_e  [ppooiinnttss__iinn==_n_a_m_e]
       [tteexxtt__iinn==_n_a_m_e]	vveeccttoorr__oouutt==_n_a_m_e    [iiddccooll==_v_a_l_u_e]    [ccaatt--
       ccooll==_v_a_l_u_e] [aattttccooll==_v_a_l_u_e]





       Alternately, the user can type:


       vv..iinn..aarrcc



       on  the	command  line without program arguments;  in this
       case, the program will prompt the user for the  flag  set-
       ting and parameter values in the manner shown below.




       In ARC/INFO, three files are used to store polygon data:


       1)  a  _l_i_n_e_s  _f_i_l_e,  which contains coordinates of all the
       area edge lines; 2) a  _l_a_b_e_l_-_p_o_i_n_t  _f_i_l_e,  which  contains
       coordinates  of label-points (each of which has associated
       with it a unique label-point ID number).  One  label-point
       is associated with each polygon defined in the _l_i_n_e_s _f_i_l_e;
       3) a _l_a_b_e_l_-_t_e_x_t _f_i_l_e, which associates each label-point ID
       number  with  a category number and category ("attribute")
       text.

       Linear feature data are stored in two files:  1)  a  _l_i_n_e_s
       _f_i_l_e,   which  contains	geographic  coordinates  defining
       lines, each with a line-ID number;  and	2)  a  _l_a_b_e_l_-_t_e_x_t
       _f_i_l_e, which associates each line-ID number with a category
       number and attribute text.




       These data files are described in  further  detail  below,
       under the DATA FILE FORMATS section.

IINNTTEERRAACCTTIIVVEE MMOODDEE
       The  program will prompt the user for the flag setting and
       parameter values if the user does not specify these on the
       command	line.	First, the user will be asked to assign a
       name to the vector file to store program output:

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

       Next,  the user is asked to specify the COVERAGE (feature)
       type to be imported into GRASS.	Valid coverage types  are
       ppoollyyggoonn and lliinnee.

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

       IMPORTING A POLYGON COVERAGE


       If  the	user  chooses POLYGON coverage, he is asked if he
       wishes a neatline placed around his data.  (The	existence
       of  neatlines in the output file can facilitate subsequent
       patching of data files.)

	    NEATLINE
	    Do you want a neatline ?
	    Enter "yes" or "no"
	    >

       If the user types yyeess, vectors that box the data  will  be
       inserted  into  the GRASS vector output file (_v_e_c_t_o_r___o_u_t);
       otherwise, no neatline will be inserted	into  the  output
       file.


       Next,  the  user  is  prompted for the name of an existing
       lines-file containing the geographic  coordinates  of  the
       arcs  forming  polygon perimeters.  The lines-file is cre-
       ated with the ARC/INFO _U_n_g_e_n_e_r_a_t_e _L_I_N_E_S option, and is  in
       the same format at the _p_r_e_f_i_x_._p_o_l file created by the

       _v_._o_u_t_._a_r_c
	program.  The user sees the following prompt:

	    LINES FILENAME
	    Enter name of the file created with the LINES
	    option of the ARC/INFO Ungenerate command.
	    Hit RETURN to cancel request
	    >

       The  next  prompt for coverage type "polygon" asks for the
       name of an existing label-points file.	The  label-points
       file  is created with the _U_n_g_e_n_e_r_a_t_e _P_O_I_N_T_S option, and is
       in the same format as the _p_r_e_f_i_x_._l_a_b file created by the

       _v_._o_u_t_._a_r_c
	program.  The user sees the following prompt:

	    LABEL-POINTS FILENAME
	    Enter name of file created with the POINTS
	    option of the ARC/INFO Ungenerate command.
	    Hit RETURN if there is no such file
	    >

       Finally, the program asks the user  for	the  name  of  an
       existing  label-text  file.   This  file  associates  each
       label-point ID number with a text string.  It  is  in  the
       same format as the _p_r_e_f_i_x_._t_x_t file created by the

       _v_._o_u_t_._a_r_c
	program.

	    LABEL-TEXT FILENAME
	    Enter the name of a file that associates
	    label-point ID numbers with text label strings
	    Hit RETURN if there is no such file
	    >

       _v_._i_n_._a_r_c  then  scans the label-text file to find the num-
       bers of lines and columns, the column  headers  (if  any),
       and  the first three lines of actual data in the file.  It
       displays this information to standard output to	help  the
       user  determine	which  columns will hold the ID, Category
       value, and Attribute text data in the  new  vector  output
       file.  A sample of the program's output is shown below:

	  The LABEL-TEXT file has been scanned. There are 132
	  lines in the file and 8 columns in the file

	  Column headers of the LABEL-TEXT file:
	    rec# AREA	 PERIMETER    SOILS# SOILS-ID	SOIL-CODE
       DRAIN_CODE TXTUR-CODE

	  Here are the first three lines :
	       1   -2.30228E+07  19399.848	1	0	0
       0      0
	       2      81079.875     1678.826	  2	 1     15
       3      3
	       3    955952.500	 10229.637	3	2      19
       8      8

       The  column  of	category values must contain only integer
       values.	The attribute text column can contain a  floating
       point number, an integer, or a word (text string).


       Finally,  the  user is prompted to enter line ID, category
       value, and attribute text column numbers.

	    Enter the number of the column that should be used
	    for line IDs (probably the column with -ID) :

	       Enter the number of the column that is to be used
	       for GRASS category values:

	       Enter the number of the column that should be used
	       for GRASS attribute text:

       Once these column numbers have been entered, _v_._i_n_._a_r_c will
       begin converting the ARC/INFO "Generate" format files into
       GRASS vector file format.


       IMPORTING A LINE COVERAGE


       The  user  will	also be prompted for input when importing
       ARC/INFO files containing linear  features  ("line  cover-
       age")  data.   Like polygon data, linear features are con-
       structed by the series of  arcs	(aka,  vectors)  defining
       their  perimeters.  If the user selects LINE coverage, the
       prompts seen by the user will be different in two respects
       from those for POLYGON coverage.  First, the user will not
       be asked whether or not a neatline is desired;	and  sec-
       ond,  no  label-points  file  name  will be requested.  In
       other respects, the treatment of LINE coverage is  identi-
       cal to that for POLYGON coverage.


       The  user  is prompted for the name of the lines-file con-
       taining the geographic coordinates  of  these  arcs.   The
       lines-file  must first have been created with the ARC/INFO
       _U_n_g_e_n_e_r_a_t_e _L_I_N_E_S option, and is in the same format as  the
       _p_r_e_f_i_x_._l_i_n file created by the GRASS _v_._o_u_t_._a_r_c
	program.



DDAATTAA FFIILLEE FFOORRMMAATTSS
       Following  are examples of the data files discussed above.


       LINES FILE, also known as _p_r_e_f_i_x_._l_i_n or _p_r_e_f_i_x_._p_o_l file.


       This type of file can be created in ARC/INFO by using  the
       _l_i_n_e_s  subcommand  of  the _U_n_g_e_n_e_r_a_t_e command.	Each line
       (aka, arc) is defined by a line-ID number, followed  by	a
       list  of  at  least  two  easting  and northing coordinate
       pairs, followed by a line with the word "END".	The  file
       is terminated with the word "END".


       The  line-ID  number  is  important only for line coverage
       data.  For a line coverage, the line-ID number is the num-
       ber that associates each line with its attribute data.

       3
       711916.000000  4651803.000000
       711351.875000  4651786.000000
       END
       3
       709562.500000  4651731.000000
       709617.250000  4651624.000000
       709617.250000  4651567.000000
       709585.000000  4651503.000000
       709601.125000  4651470.000000
       709696.875000  4651503.000000
       709720.500000  4651574.000000
       709823.750000  4651575.000000
       709893.125000  4651741.000000
       END
       3
       710296.875000  4651491.000000
       710295.125000  4651470.000000
       710223.000000  4651454.000000
       710154.500000  4651463.000000
       END
       END



       LABEL-POINTS FILE, also known as _p_r_e_f_i_x_._l_a_b file.


       This  type  of  file  can be created in ARC/INFO using the
       _P_o_i_n_t_s option of the _U_n_g_e_n_e_r_a_t_e command.  The first number
       on each line is a label-point ID number, and the following
       two numbers are (respectively) the  easting  and  northing
       coordinate  pair  representing  the geographic location of
       the label-point.

       1    711539.875000  4651743.000000
       2    711429.000000  4650632.000000
       3    711027.625000  4651736.000000
       4    711022.625000  4651519.000000
       5    710482.750000  4651494.000000
       6    710474.500000  4651667.000000
       7    709269.750000  4651018.000000
       8    709726.500000  4651604.000000
       9    708926.375000  4651195.000000
       10   708567.500000  4651644.000000
       11   708272.750000  4651407.000000
       END

       LABEL-TEXT FILE, also known as _p_r_e_f_i_x_._t_x_t file.


       The ARC/INFO _D_i_s_p_l_a_y command can be used  to  create  this
       type of file.

       1    -2.30228E+07   19399.848 1	  0    0    0
       2    81079.875 1678.826	2    1	  15   3
       3    955952.500	   10229.637 3	  2    19   8
       4    41530.875 926.887		4 3    17   3
       5    87900.188 1900.909	5    4	  13   3
       6    166125.125	   3512.950  6	  5    15   3
       7    29460.563 824.968	7    6	  17   3
       8    1022769.875    9105.707  8	  7    20   9
       9    51385.500 1075.638	9    8	  17   3
       10   376834.875	   4470.027  10   9    9    2
       11   65802.688 1575.088	11   10   16   3


NNOOTTEESS
       ARC/INFO  data  can  be	imported  even	if a label-points
       and/or a label-text file are missing;  however, the  lines
       and/or areas imported will not be labeled.


       _v_._i_n_._a_r_c can handle label-text files both with and without
       header lines.


       Import files are read from  any	directory,  v.in.arc  can
       handle relative or absolute file names with path.

SSEEEE AALLSSOO
       _v_._i_n_._s_h_a_p_e_, _v_._i_n_._d_x_f_, _v_._o_u_t_._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.in.arc(1)
