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 representing 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 location.


       As site files can consist of  several  attribute  fields  (decimals  or
       string categories), the user can select the column of interest for con-
       version using the filed	selection  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)
