r.rescale(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

✨ r.rescale — GRASS GIS User's Manual ✨

okay bestie, welcome to the r.rescale(1) page 💖 this is the GRASS GIS User's Manual entry, and we're gonna go through it together, no skipping, no skimming, we're eating the whole thing 🍓

🎀 NAME 🎀

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

🌸 KEYWORDS 🌸

raster, rescale

✨ SYNOPSIS ✨

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

🦋 Flags:

  • --overwrite — Allow output files to overwrite existing files 👀 (yes she will absolutely bulldoze what's there, that's the whole point)
  • --help — Print usage summary
  • --verbose — Verbose module output
  • --quiet — Quiet module output 🤫
  • --ui — Force launching GUI dialog

💜 Parameters:

  • input=name [required] — The name of the raster map to be rescaled
  • from=min,max — The input data range to be rescaled (default: full range of input map)
  • output=name [required] — The resulting raster map name
  • to=min,max [required] — The output data range
  • title=phrase — Title for new raster map

🌈 DESCRIPTION 🌈

So the r.rescale program rescales the range of category values appearing in a raster map layer. It generates a new raster map layer, plus an appropriate category file and color table based upon the original raster map layer, and the category labels reflect the original category values that produced each category. ✨

This command is useful for producing representations with a reduced number of categories from a raster map layer with a large range of category values (e.g., elevation). Rescaled map layers are appropriate for use in such GRASS GIS commands as r.stats, r.report, and r.coin. 🫶

💖 EXAMPLE 💖

To 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 (without the from parameter, the full value range will be used):

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

⭐ NOTES ⭐

Category values that fall beyond the input range will become NULL. 😭 This allows the user to select a subset of the full category value range for rescaling if desired. This also means that the user should know the category value range for the input raster map layer — like, actually know it, bestie. 👑

The user can request the r.rescale 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, the input raster map layer is examined, and the minimum and maximum non-NULL category values are selected as the input range. 💅

🔥 SEE ALSO 🔥

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

👑 AUTHOR 👑

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

🦋 SOURCE CODE 🦋

Available at: r.rescale source code (history)

Accessed: Saturday Jan 17 05:40:58 2026

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

okay that's the whole page, no cap 💀 before you go — this was the GRASS GIS 8.4.2 Reference Manual, © 2003-2025 GRASS Development Team, accessed Saturday Jan 17 05:40:58 2026 🌸 you're doing amazing sweetie, go rescale something iconic 💅✨

📦 where this page comes from