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 programs operate on raster data.

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

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



       The user can run the program non-interactively by specifying 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	running  _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 his-
       tory 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)
