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



NNAAMMEE
       vv..ttoo..rraasstt  - Converts a binary GRASS vector map layer into
       a GRASS raster map layer.
       _(_G_R_A_S_S _V_e_c_t_o_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..ttoo..rraasstt
       vv..ttoo..rraasstt hheellpp
       vv..ttoo..rraasstt iinnppuutt==_n_a_m_e oouuttppuutt==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       _v_._t_o_._r_a_s_t transforms (binary) GRASS vector map layers into
       GRASS  raster  map layer format.  Most GRASS analysis pro-
       grams operate on raster data.

OOPPTTIIOONNSS
   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      Name of the binary vector  map  layer  to  be  con-
	      verted.

       oouuttppuutt==_n_a_m_e
	      Name to be assigned to the raster map layer output.



       The user can run the program non-interactively by specify-
       ing  the  names	of  a vector input file and raster output
       file on	the  command  line,  using  the  form:	vv..ttoo..rraasstt
       iinnppuutt==_n_a_m_e oouuttppuutt==_n_a_m_e

       If  the user instead types simply vv..ttoo..rraasstt on the command
       line, the program will prompt  the  user  to  enter  these
       names.

NNOOTTEESS
       _v_._t_o_._r_a_s_t  will only affect data in areas lying inside the
       boundaries of the current geographic region.  Before  run-
       ning  _v_._t_o_._r_a_s_t, the user should therefore ensure that the
       current geographic region is correctly set  and	that  the
       region resolution is at the desired level; the program may
       otherwise create an empty  raster  map  layer.	An  empty
       raster  map  layer  will also be created if the vector map
       layer has  not  been  assigned  category/attribute  labels
       (e.g., through use of the _v_._d_i_g_i_t program).


       The  _v_._t_o_._r_a_s_t  program	creates  two  files: a raster map
       layer, and a history file.  The	GRASS  program	_r_._s_u_p_p_o_r_t
       must  be  run  to  create additional support files for the
       raster map.


       Additional problems sometimes  lead  to	the  creation  of
       empty  raster  map  layers.  Unfortunately, error messages
       explaining these phenomena do not yet exist.

SSEEEE AALLSSOO
       _g_._r_e_g_i_o_n, _r_._p_o_l_y, _r_._l_i_n_e,  _r_._s_u_p_p_o_r_t,  _v_._d_i_g_i_t,	_v_._i_m_p_o_r_t,
       _v_._s_u_p_p_o_r_t

AAUUTTHHOORRSS
       Michael	 Shapiro,   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_1_/_2_5 _0_5_:_4_5_:_3_5 _$



GRASS 5.0					     v.to.rast(1)
