r.basins.fill(1grass)

✨ r.basins.fill ✨

okay bestie, welcome to the GRASS User's Manual</p> page for r.basins.fill — she's a raster module and she's here to generate watershed subbasins raster maps 💧👑

🌸 KEYWORDS 🌸

raster, hydrology, watershed

---

🎀 SYNOPSIS 🎀

r.basins.fill
r.basins.fill --help
r.basins.fill cnetwork=name tnetwork=name output=name number=integer
[--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

✨ Flags ✨

• --overwrite — bestie this one lets your output files just go ahead and overwrite files that already exist. permission granted 💅
• --help — prints the usage summary, aka the little cheat sheet
• --verbose — verbose module output, she's gonna talk more
• --quiet — quiet module output, she's gonna talk less 🤫
• --ui — force launching the GUI dialog, for when you want the pretty buttons

🦋 Parameters 🦋

• cnetwork=name [required] — name of the input coded stream network raster map
• tnetwork=name [required] — name of the input thinned ridge network raster map
• output=name [required] — name for the output raster map
• number=integer [required] — number of passes through the dataset (yes you must give her a number, no she will not guess)

---

💖 DESCRIPTION 💖

so, r.basins.fill generates a raster map layer depicting subbasins, based on input raster map layers — one for the coded stream network (where each channel segment has been "coded" with a unique category value) and one for the ridges within a given watershed. 🏔️

the raster map layer depicting ridges should include the ridge which defines the perimeter of the watershed, okay? don't skip the perimeter ridge, she needs it fr fr.

the coded stream network can be generated as part of the r.watershed program, but the map layer of ridges will need to be created by hand (for example, through digitizing done in wxGUI vector digitizer). yes bestie, manually. iykyk 😭✍️

the resulting output raster map layer will code the subbasins 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 program should be rerun with a higher number of passes. no cap — holes mean bump up number and run her again 🕳️➡️✨

---

🌈 NOTES 🌈

the current geographic region setting is ignored. instead, the geographic region for the entire input stream's map layer is used. so don't come for her about your region settings, she's got her own vibe check going on 😌

---

👑 SEE ALSO 👑

see Appendix A of the GRASS Tutorial: r.watershed for further details on the combined use of r.basins.fill and r.watershed. 📚

• r.water.outlet
• r.watershed
• wxGUI vector digitizer

---

🫶 AUTHORS 🫶

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

---

⭐ SOURCE CODE ⭐

available at: r.basins.fill source code (history)

latest change: Tuesday Mar 04 21:25:20 2025 in commit: 9227329b2af8a13e1ab2730b5c863bf096510a46

Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

---

and that's the whole page, bestie 💜 huge thanks to the legends above — source code © 2003-2026 GRASS Development Team, and this is the GRASS 8.5.0 Reference Manual, last touched Tuesday Mar 04 21:25:20 2025. slay, hydrate, and go fill some subbasins 💅✨🎀