r.mask.points(1)       Grass User's Manual	 r.mask.points(1)



NNAAMMEE
       rr..mmaasskk..ppooiinnttss   -Examines and filters lists of points con-
       stituting lines to determine if they fall  within  current
       region and mask and optionally an additional raster map.
       _(_G_R_A_S_S _R_a_s_t_e_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr..mmaasskk..ppooiinnttss
       rr..mmaasskk..ppooiinnttss hheellpp
       rr..mmaasskk..ppooiinnttss [ --rr] [[mmaasskk==_n_a_m_e] [[iinnppuutt==_n_a_m_e] [[ffss==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       rr..mmaasskk..ppooiinnttss  filters  a list of points based on the cur-
       rent region and current mask.  The point list consists  of
       lines which have the following format

	    easting	   northing  [text]
			 .
			 .
			 .
	    easting	   northing  [text]

       The eastings and northings define points in the coordinate
       space. Each line is examined to	determine  if  the  point
       falls  within  the  current region, current mask (if any),
       and optionally an additional raster map	that  acts  as	a
       secondary  mask.  If  the  point falls outside the current
       region or falls in a grid cell that has value zero (either
       in the current mask, or the specified mask file), then the
       entire line is suppressed. Otherwise it is printed exactly
       as it is input.	There may be arbitrary text following the
       coordinate pairs and this text is output as well.

OOPPTTIIOONNSS
       FFllaaggss

       --rr     Coordinates are reversed: north east


       Normal input has the east first and the north second. This
       option  allows  the  order  of the coordinates to be north
       first and east next.


       PPaarraammeetteerrss

       mmaasskk==_n_a_m_e
	      Raster map used to mask points


       This parameter is optional. If  not  specified,	then  the
       points  are mask by the default mask (if there is one). If
       it is specified, then the points are mask by this layer as
       well as the default mask.

       iinnppuutt==_n_a_m_e
	      Unix input containing point list


       If  not	specified it is assumed that the user will either
       redirect the input from a file:


       rr..mmaasskk..ppooiinnttss < file



       or pipe the results from some other process (e.g., a  DBMS
       query) into
	_r_._m_a_s_k_._p_o_i_n_t_s


       some_process | rr..mmaasskk..ppooiinnttss




       ffss==_c_h_a_r_a_c_t_e_r
	      Input field separator character


       If  the	coordinates are not separated by white space, but
       by some other character, this option specifies that  char-
       acter.  For  example,  if a colon is used between the east
       and north, then
	_r_._m_a_s_k_._._p_o_i_n_t can be told this by:


	rr..mmaasskk..ppooiinnttss ffss==_:





NNOOTTEESS
       Lines that  make  it  through  the  filtering  are  output
       intact.	This  means  that if the coordinates are reversed
       they will remain reversed on output.  If there is a  field
       separator, it will also be output.

SSEEEE AALLSSOO
       _r_._m_a_s_k

       _s_._o_u_t_._a_s_c_i_i

       _s_._i_n_._a_s_c_i_i

       _d_._p_o_i_n_t_s



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.mask.points(1)
