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



NNAAMMEE
       rr..iinn..ppoollyy   -  Create raster maps from ascii polygon/line data files in
       the current directory.
       _(_G_R_A_S_S _R_a_s_t_e_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr..iinn..ppoollyy
       rr..iinn..ppoollyy hheellpp
       rr..iinn..ppoollyy iinnppuutt==_n_a_m_e oouuttppuutt==_n_a_m_e [TTIITTLLEE==_"_p_h_r_a_s_e_"] [rroowwss==_v_a_l_u_e]

DDEESSCCRRIIPPTTIIOONN
       _r_._i_n_._p_o_l_y allows the creation of GRASS binary raster  maps  from  ASCII
       files  in the current directory containing polygon and linear features.

OOPPTTIIOONNSS
   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      Unix input file, in ascii format,  containing  the  polygon  and
	      linear  features.   The  format of this file is described in the
	      section IINNPPUUTT FFOORRMMAATT below.

       oouuttppuutt==_n_a_m_e
	      Raster output file

       TTIITTLLEE== Title for resultant raster map (optional)

       rroowwss==_v_a_l_u_e
	      Number of rows to hold in memory (default: 512).	This parameter
	      allows  users with less memory (or more) on their system to con-
	      trol how much memory _r_._i_n_._p_o_l_y uses.


IINNPPUUTT FFOORRMMAATT
       The input format for the iinnppuutt file  consists  of  sections  describing
       either polygonal areas or linear features.  The basic format is:

       A		      <for polygonal areas>
	   easting northing
	   .
	   .
	   .
       =   cat# label
       L		      <for linear features>
	   easting northing
	   .
	   .
	   .
       =   cat# label

       The  _A  signals the beginning of a polygon. It must appear in the first
       column.	The _L signal the beginning of a linear feature. It  also  must
       appear  in  the	first  column.	The coordinates of the vertices of the
       polygon, or the coordinates defining the linear feature follow and must
       have  a	space  in  the first column and at least one space between the
       _e_a_s_t_i_n_g and the _n_o_r_t_h_i_n_g_. To give meaning to the features, the _=  indi-
       cates  that  the  feature  currently being processed has category value
       _c_a_t_# (which must be an integer) and a _l_a_b_e_l (which may be more than one
       word, or which may be omitted).

EEXXAAMMPPLLEE
       An area described by four points:

	 A
	 591316.80   4926455.50
	 591410.25   4926482.40
	 591434.60   4926393.60
	 591341.20   4926368.70
	 = 42 stadium


SSEEEE AALLSSOO
       r.digit	for  interactive  on-screen polygon/line digitizing for raster
       maps


       r.colors for creates color tables for raster maps

AAUUTTHHOORR
       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_3_/_0_7_/_0_4 _0_8_:_3_5_:_3_4 _$



GRASS 5.0							  r.in.poly(1)
