r.profile(1)	       Grass User's Manual	     r.profile(1)



NNAAMMEE
       rr..pprrooffiillee   - Outputs the raster map layer values lying on
       user-defined line(s).
       _(_G_R_A_S_S _R_a_s_t_e_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr..pprrooffiillee
       rr..pprrooffiillee hheellpp
       rr..pprrooffiillee   [[--gg]]   [[--ii]]	  iinnppuutt=_n_a_m_e   oouuttppuutt=_n_a_m_e   pprroo--
       ffiillee=_e_a_s_t,_n_o_r_t_h[,_e_a_s_t,_n_o_r_t_h,_e_a_s_t,_n_o_r_t_h,...]    rreess=_r_e_s_o_l_u_-
       _t_i_o_n

DDEESSCCRRIIPPTTIIOONN
       This program outputs a two or four column (with -g)  ASCII
       file  (or  stdout). The default two column output consists
       of cumulative profile length in meters and  raster  value.
       The  optional  four  column output consists of an easting,
       northing, cumlative profile length (m), and raster  value.
       Profile	end  or "turning" points can be set manually with
       the _p_r_o_f_i_l_e argument or selected  interactively	from  the
       GRASS  monitor by setting the _-_i flag. The profile resolu-
       tion, or distance between profile points, is obatined from
       the current region resolution, or can be manually set with
       the _r_e_s argument.

OOPPTTIIOONNSS
   FFllaaggss::
       --gg     Output easting and northing in first two columns of
	      four column output

       --ii     Intercative  mode The user selects the profile from
	      the GRASS monitor by clicking the left mouse button
	      along  the profile, clicking the right mouse button
	      ends the profile


   PPaarraammeetteerrss::
       iinnppuutt  The name of the GRASS raster  file  from	which  to
	      generate the profile info

       oouuttppuutt The  name  of  the 2 or 4 column ASCII file to send
	      profile results to Use "_-" to send output to  stan-
	      dard output (stdout)

       pprrooffiillee
	      The comma seperated geographic coordinates for pro-
	      file line endpoints The interactive flag (_-_i) over-
	      rides this option

       rreess    This  sets  the distance between each profile point
	      (resolution) The resolution  must  be  provided  in
	      GRASS  database units (i.e. decimal degrees for Lat
	      Long database and meters for UTM) By default _r_._p_r_o_-
	      _f_i_l_e  uses  the  resolution  of  the  current GRASS
	      region


OOUUTTPPUUTT FFOORRMMAATT
       The 2 or 4 column output from  _r_._p_r_o_f_i_l_e  is  intened  for
       easy  use  in other programs.  The output can be piped (|)
       directly into other programs or saved to  file  for  later
       use.   The  4  column output is compatible with _s_._i_n_._a_s_c_i_i
       and can be piped direcly into this program for later plot-
       ting.

       r.profile   -ig	 input=elev.rast  output=-  |  s.in.ascii
       sites=elev.profile

       The 2 column output is compatible with most plotting  pro-
       grams.

NNOOTTEESS
       The  profile  resolution is measured exactly from the sup-
       plied end or "turning" point along the profile.	 The  end
       of a profile segment will be an exact multiple of the pro-
       file resolution and will therefore not  always  match  the
       end point coordinates entered for the segmanet.


       To  extract  the  numbers in scripts, following parameters
       can be used:

		  r.profile  dgm12.5  prof=3570631,5763556  out=-
       2>/dev/null

       This filters out the everything except the numbers.

SSEEEE AALLSSOO
       _d_._p_r_o_f_i_l_e

       _r_._w_h_a_t

       _r_._t_r_a_n_s_e_c_t

AAUUTTHHOORR
       Bob Covill

       _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.profile(1)
