r.basins.fill(1)	      Grass User's Manual	      r.basins.fill(1)



NNAAMMEE
       rr..bbaassiinnss..ffiillll   -  Generates  a raster map layer showing watershed sub-
       basins.
       _(_G_R_A_S_S _R_a_s_t_e_r _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr..bbaassiinnss..ffiillll
       rr..bbaassiinnss..ffiillll hheellpp
       rr..bbaassiinnss..ffiillll nnuummbbeerr==_v_a_l_u_e cc__mmaapp==_n_a_m_e tt__mmaapp==_n_a_m_e rreessuulltt==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       _r_._b_a_s_i_n_s_._f_i_l_l generates a raster map layer depicting  subbasins,  based
       on  input  raster  map  layers for the coded stream network (where each
       channel segment has been "coded" with a unique category value) and  for
       the  ridges  within  a given watershed.	The raster map layer depicting
       ridges should include the ridge which  defines  the  perimeter  of  the
       watershed.   The  coded	stream network can be generated as part of the
       _r_._w_a_t_e_r_s_h_e_d program, but the map layer of ridges will need to  be  cre-
       ated by hand, either through digitizing done in _v_._d_i_g_i_t, or through the
       on-screen digitizing option accessible within _d_._d_i_s_p_l_a_y.


       The resulting output raster map layer will code the subbasins with cat-
       egory  values  matching	those  of the channel segments passing through
       them.  A user-supplied number of passes through the data is made in  an
       attempt	to  fill  in these subbasins.  If the resulting map layer from
       this program appears to have  holes  within  a  subbasin,  the  program
       should be rerun with a higher number of passes.


       The  user  can  run  _r_._b_a_s_i_n_s_._f_i_l_l either interactively or non-interac-
       tively.	If the user simply types rr..bbaassiinnss..ffiillll without other arguments
       on  the	command  line, the program will prompt the user for the needed
       parameters using the standard GRASS _p_a_r_s_e_r interface.


       If the user wishes to run the program non-interactively, the  following
       parameter values must be specified on the command line:



   PPaarraammeetteerrss::
       nnuummbbeerr==_v_a_l_u_e
	      The number of passes to be made through the dataset.

       cc__mmaapp==_n_a_m_e
	      The coded stream network file name.

       tt__mmaapp==_n_a_m_e
	      The thinned ridge network file name.

       rreessuulltt==_n_a_m_e
	      The resultant watershed partition file name.


NNOOTTEESS
       The  current  geographic  region setting is ignored.  Instead, the geo-
       graphic region for the entire input stream's map layer is used.

SSEEEE AALLSSOO
       See Appendix A of the GGRRAASSSS Tutorial: r.watershed for  further  details
       on the combined use of _r_._b_a_s_i_n_s_._f_i_l_l and _r_._w_a_t_e_r_s_h_e_d.


       _d_._d_i_s_p_l_a_y

       _r_._w_a_t_e_r_s_h_e_d

       _v_._d_i_g_i_t

       _p_a_r_s_e_r

AAUUTTHHOORRSS
       Dale White, Dept. of Geography, Pennsylvania State University
       Larry Band, Dept. of Geography, University of Toronto, Canada

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