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



NNAAMMEE
       vv..iinn..aasscciiii   -  Converts ASCII vector map layers into binary vector map
       layers.
       _(_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..aasscciiii
       vv..iinn..aasscciiii hheellpp
       vv..iinn..aasscciiii iinnppuutt==_n_a_m_e oouuttppuutt==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       _v_._i_n_._a_s_c_i_i converts a vector map in ASCII format to  a  vector  map  in
       binary format.

OOPPTTIIOONNSS
       The  user can run this program non-interactively by specifying all pro-
       gram options on the command line, in the  form:	vv..iinn..aasscciiii  iinnppuutt==_n_a_m_e
       oouuttppuutt==_n_a_m_e


   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      Name  of	an  ASCII vector file to be converted to binary vector
	      file.

       oouuttppuutt==_n_a_m_e
	      Name given to binary vector output file.

       If the user runs _v_._i_n_._a_s_c_i_i without giving  program  arguments  on  the
       command	line,  the  program  will prompt the user for _i_n_p_u_t and _o_u_t_p_u_t
       file names.

NNOOTTEESS
       After running this program, GRASS support files must be built  for  the
       binary  _o_u_t_p_u_t  file  before the user can use the file in _v_._d_i_g_i_t.  The
       user can run _v_._s_u_p_p_o_r_t to create GRASS support  files  for  the	_o_u_t_p_u_t
       file.


       Note, that the coordinates order is NORTH EAST.


       To  import  category labels, the dig_cats file needs to be specified in
       OTHER INFO field.


       Example ASCII vector file (store in dig_ascii/). Note the blank	before
       entering vertex coordinates:



	      ORGANIZATION:
	      DIGIT DATE:   Oct 24 2001
	      DIGIT NAME:   nds_gem
	      MAP NAME:     nds_gem
	      MAP DATE:
	      MAP SCALE:    500000
	      OTHER	 INFO:	      /home/neteler/grassdata5/langeoog/PERMA-
       NENT/dig_cats
	      ZONE:	    0
	      WEST EDGE:    3399965.343
	      EAST EDGE:    3403360.343
	      SOUTH EDGE:   5957127.30045067
	      NORTH EDGE:   5960625.30045067
	      MAP THRESH:   19.05
	      VERTI:
	      A  13
	       5958812.48844435 3400828.84221011
	       5958957.29887089 3400877.11235229
	       5959021.65906046 3400930.7458436
	       5959048.47580612 3400973.65263665
	       5959069.92920264 3401032.64947709
	       5959064.56585351 3401123.82641232
	       5958994.84231481 3401188.1866019
	       5958914.39207784 3401188.1866019
	       5958823.21514261 3401107.73636493
	       5958753.49160391 3401005.83273144
	       5958753.49160391 3400941.47254186
	       5958780.30834956 3400887.83905055
	       5958812.48844435 3400828.84221011
	      A  8
	       5959010.9323622 3401338.36037757
	       5959096.7459483 3401370.54047235
	       5959091.38259917 3401450.99070932
	       5958973.38891828 3401520.71424803
	       5958882.21198305 3401467.08075671
	       5958903.66537958 3401375.90382148
	       5958941.2088235 3401332.99702844
	       5959010.9323622 3401338.36037757
	 The  associated  dig_att  file  needs	following  format  (store   in
       dig_att/):



	      A 3401180.463379 5959003.209139	       1
	      A 3401516.741397 5958966.635071	       2



       The associated dig_cats file needs following format:



	      # 2 categories


	      0.00 0.00 0.00 0.00
	      1:forest
	      2:water



       To  (re-)set  map metadata like ORGANIZATION etc. later, _v_._d_i_g_i_t can be
       used.


       The GRASS program _v_._o_u_t_._a_s_c_i_i performs the function  of	_v_._i_n_._a_s_c_i_i  in
       reverse;  i.e., it converts vector files in binary format to ASCII for-
       mat.  These two companion programs are useful both  for	importing  and
       exporting vector files between GRASS and other software, and for trans-
       ferring data between machines.


       The input from _v_._i_n_._a_s_c_i_i has to  be  placed  into  $LOCATION/dig_ascii
       (this directory must be created if not existing).

SSEEEE AALLSSOO
       _v_._d_i_g_i_t, _v_._i_m_p_o_r_t, _v_._o_u_t_._a_s_c_i_i, _v_._s_u_p_p_o_r_t, _G_R_A_S_S _A_S_C_I_I _f_o_r_m_a_t_s

AAUUTTHHOORRSS
       Michael Higgins, U.S.Army Construction Engineering Research Laboratory

       James Westervelt, U.S.Army Construction Engineering Research Laboratory

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_3_/_1_1 _1_4_:_0_4_:_0_3 _$



GRASS 5.0							 v.in.ascii(1)
