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 nnoorrtthhiinngg==_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 negative 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 watershed basin. Val-
	      ues 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 repre-
       senting 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 Labo-
       ratory

       _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)
