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 vec-
       tor map in binary format.

OOPPTTIIOONNSS
       The  user can run this program non-interactively by speci-
       fying all program 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  argu-
       ments  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/lan-
       geoog/PERMANENT/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 format.  These two  companion  pro-
       grams  are  useful both for importing and exporting vector
       files between GRASS and other software, and for	transfer-
       ring data between machines.


       The  input  from  _v_._i_n_._a_s_c_i_i  has to be placed into $LOCA-
       TION/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)
