r.tile(1)

✨ NAME ✨

r.tile — bestie, this one splits a raster map into tiles. That's it, that's the whole vibe 💅

It lives in the GRASS GIS User's Manual, and honestly? It's giving unsung hero.

---

🎀 KEYWORDS 🎀

raster, tiling

---

🌸 SYNOPSIS 🌸

r.tile
r.tile --help
r.tile input=name output=string width=integer height=integer
       [overlap=integer]   [--help]  [--verbose]  [--quiet]  [--ui]

🦋 Flags:

• --help — prints you the usage summary, the little cheat sheet, iconic
• --verbose — verbose module output, so it tells you everything it's doing
• --quiet — quiet module output, for when you want zero chit-chat
• --ui — forces the GUI dialog to launch, if you're feeling clicky

💜 Parameters:

• input=name [required] — the name of the input raster map, aka the thing you're about to chop up
• output=string [required] — output base name, the prefix every tile is gonna inherit
• width=integer [required] — width of tiles, counted in columns
• height=integer [required] — height of tiles, counted in rows
• overlap=integer — overlap of tiles, and yes it's in rows/columns

---

💖 DESCRIPTION 💖

r.tile retiles an existing raster map with user defined x and y tile size. So like, you hand it a raster, you tell it how big you want the chunks, and it goes off and does the thing. No cap. 🫶

---

⭐ NOTES ⭐

r.tile generates a separate raster for each tile. The way that it works out to the exact same result as running g.region along with r.resample in a double loop — that's the energy, fr fr.

The module can be used to split a large raster map into smaller tiles, e.g. for further parallelized analysis on a cluster computing system. So if you're about to throw a giant map at a compute cluster, this is literally the glow-up step first. 👑

The overlap is defined in rows/columns.

---

🔥 EXAMPLE 🔥

Retiling example for the North Carolina DEM:

g.region raster=elevation -p
# rows:       1350
# cols:       1500
# generating 2 x 2 = 4 tiles (width=1500/2, height=rows/2)
r.tile input=elevation output=elev_tile width=750 height=675

creates 4 tiles with the prefix elev_tile (named: elev_tile-000-000, elev_tile-000-001, elev_tile-001-000, ...).

Not the naming convention being that cute 😭 zero-padded and everything. Ate.

---

🌈 SEE ALSO 🌈

g.region, r3.retile

---

👑 AUTHOR 👑

Glynn Clements

---

💀 SOURCE CODE 💀

Available at: r.tile source code (history)

Accessed: Saturday Jan 17 05:41:03 2026

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

---

Okay so that's the whole page, bestie — go tile something and slay 💅✨

This was served fresh from the GRASS GIS 8.4.2 Reference Manual, version GRASS 8.4.2, and © 2003-2025 GRASS Development Team. Thanks for coming to my TED talk, mwah 🎀🦋