r.water.outlet(1)      Grass User's Manual	r.water.outlet(1)



NNAAMMEE
       rr..wwaatteerr..oouuttlleett  - Watershed basin creation program.
       _(_G_R_A_S_S _R_a_s_t_e_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr..wwaatteerr..oouuttlleett
       rr..wwaatteerr..oouuttlleett hheellpp
       rr..wwaatteerr..oouuttlleett ddrraaiinnaaggee==_n_a_m_e bbaassiinn==_n_a_m_e eeaassttiinngg==_v_a_l_u_e nnoorr--
       tthhiinngg==_v_a_l_u_e

DDEESSCCRRIIPPTTIIOONN
       _r_._w_a_t_e_r_._o_u_t_l_e_t generates a watershed basin from a drainage
       direction  map (from _r_._w_a_t_e_r_s_h_e_d) and a set of coordinates
       representing the outlet point of watershed.

OOPPTTIIOONNSS
   PPaarraammeetteerrss
       ddrraaiinnaaggee==_n_a_m_e
	      Input  map:  drainage  direction.   Indicates   the
	      "aspect" for each cell. Multiplying positive values
	      by 45 will give the direction in degrees	that  the
	      surface  runoff  will  travel  from  that cell. The
	      value -1 indicates that the cell	is  a  depression
	      area.   Other negative values indicate that surface
	      runoff is leaving the  boundaries  of  the  current
	      geographic region. The absolute value of these neg-
	      ative cells indicates the direction of  flow.  This
	      map is generated from _r_._w_a_t_e_r_s_h_e_d.

       bbaassiinn==_n_a_m_e
	      Output  map:  Values of one (1) indicate the water-
	      shed basin. Values of zero are not in the watershed
	      basin.

       eeaassttiinngg==_v_a_l_u_e
	      Input value: Easting value of outlet point.

       nnoorrtthhiinngg==_v_a_l_u_e
	      Input value: Northing value of outlet point.


NNOOTTEESS
       In  the	context of this program, a watershed basin is the
       region upstream of an outlet  point.  Thus,  if	the  user
       chooses an outlet point on a hill slope, the resulting map
       will be a thin silver of land  representing  the  overland
       slope uphill of the point.

SSEEEE AALLSSOO
       _d_._w_h_e_r_e_, _r_._w_a_t_e_r_s_h_e_d_, _r_._t_o_p_i_d_x


AAUUTTHHOORR
       Charles	Ehlschlaeger,  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.water.outlet(1)
