s.to.rast(1)	       Grass User's Manual	     s.to.rast(1)



NNAAMMEE
       ss..ttoo..rraasstt  - Converts a site file to a raster map
       _(_G_R_A_S_S _S_i_t_e_s _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       ss..ttoo..rraasstt
       ss..ttoo..rraasstt hheellpp
       ss..ttoo..rraasstt    [--qqss]   iinnppuutt==_n_a_m_e	 oouuttppuutt==_n_a_m_e   ssiizzee==_v_a_l_u_e
       ttiittllee==_"_p_h_r_a_s_e_" ffiieelldd==_v_a_l_u_e ffiinnddeexx==_v_a_l_u_e ssttrriinngg==_v_a_l_u_e

DDEESSCCRRIIPPTTIIOONN
       _s_._t_o_._r_a_s_t converts a GRASS site file  to  a  GRASS  raster
       file.


       The  quad  size	(ie the number of cells used to represent
       one site) is fixed to 0 (ie one cell/site). If the  output
       file already exists, the program exits gracefully.

OOPPTTIIOONNSS
   FFllaagg::
       --qq     Run the module quietly.

       --ss     Create a single-valued (0/1, binary) raster map


   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      Name of input site list

       oouuttppuutt==_n_a_m_e
	      Name of output cell file

       ssiizzee==_v_a_l_u_e
	      Number of cells to surround site cell

       ttiittllee== Title for the resulting raster map

       ffiieelldd==_v_a_l_u_e
	      Attribute field type to use for operation

	      options: dim,decimal,cat

	      default: decimal

       ffiinnddeexx==_v_a_l_u_e
	      Attribute field number to use for operation

	      default: 1

       ssttrriinngg==_v_a_l_u_e
	      String attribute number to use for description

	      default: 1


NNOOTTEESS
       When  converting from a sites layer to a raster layer with
       size=0, the site is converted into a  single  cell  repre-
       senting the location of the site, which can be hard to see
       (depending on the raster resolution).

       size=2 (or higher) makes the sites show up  as  fatter  in
       the raster layer.


       Alternaticely  the  user  can  convert the sites to vector
       format and use v.bubble or v.circle to represent the loca-
       tion.


       As  site  files	can  consist  of several attribute fields
       (decimals or string categories), the user can  select  the
       column  of  interest for conversion using the filed selec-
       tion parameters (findex, string). The attribute field type
       to use for operation is selected by parameter _f_i_e_l_d.


       The user will be warned if two or more sites fall into one
       raster cell.  However, the module will continue to  import
       (the  last  site  value will determine the cell value). If
       such overwriting is not wanted, the cell resolution has to
       be changed using g.region.


       The  user  will be warned if sites fall out of the current
       region.

SSEEEE AALLSSOO
       _g_._r_e_g_i_o_n, _s_._m_e_n_u, _s_._t_o_._v_e_c_t, _v_._b_u_b_b_l_e, _v_._c_i_r_c_l_e,

AAUUTTHHOORRSS
       Katarina Johnsson, CCRS

       GRASS 5 improvements: Eric G. 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_5 _$



GRASS 5.0					     s.to.rast(1)
