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



NNAAMMEE
       rr..mmaasskk..ppooiinnttss  -Examines and filters lists of points constituting 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 current region and
       current mask.  The point list consists of lines which have the  follow-
       ing 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 cur-
       rent mask, or the specified mask file), then the entire	line  is  sup-
       pressed.  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  character.  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  out-
       put.  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)
