r.rescale.eq(1)

💖 r.rescale.eq 💖

okay bestie, welcome to the GRASS GIS User's Manual page for r.rescale.eq — she's a raster girlie and she is literally here to rescale your category values with an equalized histogram. no cap. 🦋

---

✨ NAME ✨

r.rescale.eq — Rescales histogram equalized the range of category values in a raster map layer. 💅

---

🎀 KEYWORDS 🎀

raster, rescale

---

🌸 SYNOPSIS 🌸

r.rescale.eq
r.rescale.eq --help
r.rescale.eq input=name  [from=min,max]  output=name to=min,max
[title=phrase]   [--overwrite]  [--help]  [--verbose]  [--quiet]  [--ui]

🌈 Flags 🌈

• --overwrite — lets your output files just go ahead and overwrite files that already exist, periodt. 💀
• --help — prints the usage summary so you know what's up.
• --verbose — verbose module output, she's talking more now. 🗣️
• --quiet — quiet module output, she's giving mysterious silence. 🤫
• --ui — forces the GUI dialog to launch, main character energy only. 👑

🧚 Parameters 🧚

• input=name [required] — the name of the raster map that's getting rescaled. you have to give her this one.
• from=min,max — the input data range you wanna rescale (default: the full range of the input map, she'll figure it out herself).
• output=name [required] — the resulting raster map name. yes queen, name your baby.
• to=min,max [required] — the output data range.
• title=phrase — title for the new raster map, a lil label moment. 🏷️

---

🦋 DESCRIPTION 🦋

so the r.rescale.eq program rescales the range of category values that appear in a raster map layer — and it does it with an equalized histogram. it's giving glow-up but mathematically correct. ✨

a new raster map layer gets generated, plus an appropriate category file and a color table based on the original raster map layer, with category labels that reflect the original category values that produced each category. the way that it just... remembers where you came from? iconic. 💖

this command is useful for producing representations with a reduced number of categories from a raster map layer that has a large range of category values (e.g., elevation). think of it like compressing a whole vibe into a smaller, cuter vibe. 🌈

rescaled map layers are appropriate for use in such GRASS GIS commands as r.stats, r.report, and r.coin. they'll slay in there, fr fr.

---

🍓 EXAMPLE 🍓

say you wanna rescale an elevation raster map layer with category values ranging from 1090 meters to 1800 meters into the range 0-255. the following command line could be used (and heads up bestie — without the from parameter, the full value range will be used):

r.rescale.eq input=elevation from=1090,1800 output=elevation.255 to=0,255

ate. no crumbs. 💅

---

💜 NOTES 💜

okay this part matters so listen up:

• category values that fall beyond the input range will become NULL. not a vibe, but that's the deal.
• this allows the user to select a subset of the full category value range for rescaling if they want to.
• this also means the user should know the category value range for the input raster map layer. like, do your homework first. 📚
• the user can request the r.rescale.eq program to determine this range, or can obtain it using the r.describe or r.info command.
• if the category value range is determined using r.rescale.eq, the input raster map layer is examined, and the minimum and maximum non-NULL category values are selected as the input range. she does the detective work herself. 🔍

ngl, if you don't know your input range and you don't let her find it, things can get weird. let her cook. 🫶

---

⭐ SEE ALSO ⭐

r.coin, r.describe, r.info, r.mapcalc, r.reclass, r.rescale, r.report, r.resample, r.stats

the whole friend group, honestly. 💞

---

👑 AUTHOR 👑

Michael Shapiro, U.S.Army Construction Engineering Research Laboratory

---

🌟 SOURCE CODE 🌟

Available at: r.rescale.eq source code (history)

Accessed: Saturday Jan 17 05:40:58 2026

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

---

and that's the whole page bestie!! 🎀 this was pulled from the GRASS GIS 8.4.2 Reference Manual, © 2003-2025 GRASS Development Team, and the version tag on the bottom of the original was GRASS 8.4.2, under the name r.rescale.eq(1). go rescale something gorgeous. 💖✨🦋🌸