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



NNAAMMEE
       rr..bbaassiinnss..ffiillll   -  Generates  a	raster	map layer showing
       watershed subbasins.
       _(_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 sub-
       basins, 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  perime-
       ter  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 created 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 sub-
       basins with category 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  pro-
       gram 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-interactively.  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  geographic  region  for  the  entire  input
       stream's map layer is used.

SSEEEE AALLSSOO
       See Appendix A of the GGRRAASSSS Tutorial: r.watershed for fur-
       ther  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 Univer-
       sity
       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)
