r.li.dominance(1grass)

💖 r.li.dominance — the girlies' guide to the dominance diversity index 💖

okay so bestie, welcome to r.li.dominance(1grass), straight out of the GRASS User's Manual ✨ this one lives in the GRASS 8.5.0 Reference Manual and it is literally about measuring how one patch type takes over the whole vibe of your landscape. main character energy, but for raster cells 🫶

---

✨ NAME ✨

r.li.dominance — calculate the dominance's diversity index on a raster map, no cap 💅

🎀 KEYWORDS 🎀

raster, landscape structure analysis, diversity index

🌸 SYNOPSIS 🌸

r.li.dominance
r.li.dominance --help
r.li.dominance input=name config=name output=name  [--overwrite]
[--help]  [--verbose]  [--quiet]  [--ui]

🌟 Flags 🌟

• --overwrite — bestie you're allowed to let output files overwrite existing files. permission granted 💅
• --help — prints the usage summary, iykyk
• --verbose — verbose module output, she's chatty 💬
• --quiet — quiet module output, she's giving mystery 🕵️
• --ui — forces the GUI dialog to launch, no keyboard arc today 🖱️

🌈 Parameters 🌈

• input=name [required] — name of the input raster map 🌸
• config=name [required] — configuration file ⭐
• output=name [required] — name for the output raster map 💖

👑 DESCRIPTION 👑

r.li.dominance calculates the "dominance diversity index" as:

with:

• i: patch type
• m: number of different patch types
• pi: proportional abundance of patch type i

(that formula is genuinely just vibes in the original, bestie — the legend above is what you actually need 🧚)

💀 NOTES 💀

Do not use absolute path names for the config and output file/map parameters. like, seriously, don't. absolute paths are not invited to this party 🙈

If the "moving window" method was selected in g.gui.rlisetup, then the output will be a raster map. otherwise an ASCII file will be generated in the folder

C:\Users\userxy\AppData\Roaming\GRASS8\r.li\output\   (MS-Windows)

or

$HOME/.grass8/r.li/output/   (GNU/Linux)

give or take, depending on your OS obviously 🫶

If the input raster map contains only NULL values, then r.li.dominance returns NULL. like, the answer is nothing. she said no comment ✋

---

🔥 EXAMPLES 🔥

To calculate the dominance diversity index on map my_map, using the my_conf configuration file (which you defined earlier with g.gui.rlisetup, bestie) and saving results in my_out, run:

r.li.dominance input=my_map conf=my_conf output=my_out

Forest map (Spearfish sample dataset) example, iconic:

g.region raster=landcover.30m -p
r.mapcalc "forests = if(landcover.30m >= 41 && landcover.30m <= 43,1,null())"
r.li.dominance input=forests conf=movwindow7 out=forests_dominance_mov7
r.univar forests_dominance_mov7

Forest map (North Carolina sample dataset) example, also iconic:

g.region raster=landclass96 -p
r.mapcalc "forests = if(landclass96 == 5, 1, null() )"
r.li.dominance input=forests conf=movwindow7 out=forests_dominance_mov7
# verify
r.univar forests_dominance_mov7
r.to.vect input=forests output=forests type=area
d.mon wx0
d.rast forests_dominance_mov7
d.vect forests type=boundary

🦋 SEE ALSO 🦋

• r.li (package overview)
• g.gui.rlisetup

📚 REFERENCES 📚

McGarigal, K., and B. J. Marks. 1995. FRAGSTATS: spatial pattern analysis program for quantifying landscape structure. USDA For. Serv. Gen. Tech. Rep. PNW-351. (PDF)

💜 AUTHORS 💜

• Serena Pallecchi, student of Computer Science University of Pisa (Italy).
• Commission from Faunalia Pontedera (PI), Italy (www.faunalia.it)
• Markus Metz

⭐ SOURCE CODE ⭐

Available at: r.li.dominance source code (history)

Latest change: Friday Apr 17 01:04:26 2026 in commit: 32a143358df26b2e518b03c7e0d79541e8d1e5b1

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

© 2003-2026 GRASS Development Team, GRASS 8.5.0 Reference Manual

---

that's the whole page, bestie 🎀 this was r.li.dominance from the GRASS 8.5.0 Reference Manual, last touched Friday Apr 17 01:04:26 2026 (commit 32a143358df26b2e518b03c7e0d79541e8d1e5b1), © 2003-2026 GRASS Development Team — go run it on your forests and slay 💖✨🦋