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 poly-
       gon 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 control	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 lin-
       ear  feature. It also must appear in the first column. The
       coordinates of the vertices of the polygon, or the coordi-
       nates  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 fea-
       tures, the _= indicates that the	feature  currently  being
       processed  has category value _c_a_t_# (which must be an inte-
       ger) and a _l_a_b_e_l (which may be  more  than  one	word,  or
       which may be omitted).

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_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_4 _$



GRASS 5.0					     r.in.poly(1)
