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



NNAAMMEE
       rr..iinn..aasscciiii   -  Convert	an  ASCII raster text file into a
       (binary) raster map layer.
       _(_G_R_A_S_S _R_a_s_t_e_r _D_a_t_a _I_m_p_o_r_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr..iinn..aasscciiii
       rr..iinn..aasscciiii hheellpp
       rr..iinn..aasscciiii [--iiffddss] iinnppuutt==_n_a_m_e oouuttppuutt==_n_a_m_e [TTIITTLLEE=="_p_h_r_a_s_e"]
       [mmuulltt==_m_u_l_t_i_p_l_i_e_r]

DDEESSCCRRIIPPTTIIOONN
       _r_._i_n_._a_s_c_i_i allows a user to create a (binary) GRASS raster
       map layer from an ASCII raster input file with  (optional)
       TITLE.

OOPPTTIIOONNSS
   FFllaaggss::
       --ii     integer values are imported

       --ff     floating point values are imported

       --dd     double floating point values are imported

       --ss     SURFER  (Golden  Software)  ascii grid file will be
	      imported


   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      Name  of	an  existing  ASCII  raster  file  to  be
	      imported.

       oouuttppuutt==_n_a_m_e
	      Name  to be assigned to resultant binary raster map
	      layer.

       TTIITTLLEE== Title to be assigned to resultant raster map layer.

       mmuulltt==_m_u_l_t_i_p_l_i_e_r
	      Multiply	all  raster  cell  values  by _m_u_l_t_i_p_l_i_e_r.
	      _m_u_l_t_i_p_l_i_e_r is a floating point  value,  and  has	a
	      default value of 1.0.

       The  iinnppuutt  file  has a header section which describes the
       location and size  of  the  data,  followed  by	the  data
       itself.


       The header has 6 lines:
       north:	xxxxxx.xx

       south:	xxxxxx.xx

       east:	xxxxxx.xx

       west:	xxxxxx.xx

       rows:	r

       cols:	c

       The  north, south, east, and west field values entered are
       the coordinates of the edges  of  the  geographic  region.
       The rows and cols field values entered describe the dimen-
       sions of the matrix of data to  follow.	 The  data  which
       follows is _r rows of _c integers.


       Optionally  the following parameters can be defined in the
       header section:


       null: nn

       type: float

       multiplier: 2.



       "null" defines a string or number to be converted to  NULL
       value (no data).

       "type" defines the data type (int, float double) as is not
       required.

       "multiplier" is an optional  parameter  to  multiply  each
       cell value.

EEXXAAMMPPLLEE
       The following is a sample _i_n_p_u_t file to _r_._i_n_._a_s_c_i_i:


       north:			4299000.00

       south:			4247000.00

       east:			 528000.00

       west:			 500000.00

       rows:			     10

       cols:			     15

       null:			  -9999

       1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

       1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

       1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

       1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

       1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

       1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

       1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

       1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

       1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

       1 2 3 4 5 6 7 8 9 10 11 12 13 14 15


NNOOTTEESS
       The  geographic	coordinates  north, south, east, and west
       describe the outer edges of the geographic  region.   They
       run  along  the edges of the cells at the edge of the geo-
       graphic region and _n_o_t through the center of the cells  at
       the edges.


       The data (which follows the header section) must contain r
       x c values, but it is not necessary that all the data  for
       a row be on one line.  A row may be split over many lines.


       _r_._i_n_._a_s_c_i_i handles floating point cell values.


       The header information in ESRI Raster ASCII files  differs
       from  GRASS.   To convert an Arc/Info (ArcView) ASCII grid
       file into GRASS, click here.  Also, see _r_._i_n_._a_r_c to import
       ESRI Raster ASCII files.

SSEEEE AALLSSOO
       _m_._f_l_i_p_,	_r_._o_u_t_._a_s_c_i_i_, _r_._i_n_._a_r_c_, _r_._o_u_t_._a_r_c_, _r_._i_n_._b_i_n_, _G_R_A_S_S
       _A_S_C_I_I _f_o_r_m_a_t_s


AAUUTTHHOORR
       Michael	Shapiro,  U.S.	Army   Construction   Engineering
       Research Laboratory

       Surfer support by Roger Miller

       _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_4 _$



GRASS 5.0					    r.in.ascii(1)
