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 std-
       out). The default two column  output  consists  of  cumulative  profile
       length in meters and raster value. The optional four column output con-
       sists 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 resolution, or distance between pro-
       file 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 standard output (stdout)

       pprrooffiillee
	      The comma seperated geographic coordinates for profile line end-
	      points The interactive flag (_-_i) overrides 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  pro-
       grams  or saved to file for later use.  The 4 column output is compati-
       ble with _s_._i_n_._a_s_c_i_i and can be piped  direcly  into  this  program  for
       later plotting.

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

       The 2 column output is compatible with most plotting programs.

NNOOTTEESS
       The  profile  resolution  is  measured exactly from the supplied end or
       "turning" point along the profile.  The end of a profile  segment  will
       be  an  exact multiple of the profile 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)
