r.tileset(1grass)

💖 NAME 💖

ok so bestie, r.tileset — the GRASS User's Manual one — produces tilings of the source projection for use in the destination region and projection. that's it, that's the whole job, and it does it so well. 🦋

🏷️ KEYWORDS 🏷️

raster, tiling ✨

---

📜 SYNOPSIS 📜

r.tileset
r.tileset --help
r.tileset [-gw]  [region=string]  sourceproj=string
[sourcescale=string]   [destproj=string]   [destscale=string]
[maxcols=integer]   [maxrows=integer]   [overlap=integer]
[separator=character]   [--help]  [--verbose]  [--quiet]  [--ui]

🎀 Flags 🎀

• -g — produces shell script output. periodt. 💅
• -w — produces web map server query string output. iconic. 🌈
• --help — print usage summary. your little cheat sheet fr.
• --verbose — verbose module output.
• --quiet — quiet module output. shh. 🤫
• --ui — force launching GUI dialog. main character energy, but in a window.

🌸 Parameters 🌸

• region=string — name of region to use instead of current region for bounds and resolution. like, you can use the current one, but this is the override.
• sourceproj=string [required] — source projection. yes bestie it is literally required, no skipping. 😤
• sourcescale=string — conversion factor from units to meters in source projection. Default: 1.
• destproj=string — destination projection, defaults to this location's projection. (yes the typographic apostrophe, we keep it, we're fancy like that 💖)
• destscale=string — conversion factor from units to meters in source projection. (that is exactly what it says, i'm not fixing it, i'm just the messenger 🫶)
• maxcols=integer — maximum number of columns for a tile in the source projection. Default: 1024.
• maxrows=integer — maximum number of rows for a tile in the source projection. Default: 1024.
• overlap=integer — number of cells tiles should overlap in each direction. Default: 0.
• separator=character — field separator. Output field separator. Default: pipe.

---

✨ DESCRIPTION ✨

okay so here's the tea: r.tileset generates sets of tiles in another projection that cover a region in this projection with adequate resolution. basically it's out here matching your vibes across projections. 👑

by default the current region and its resolution are used — but the bounds and resolution of another region can be used via the region option. so you've got options, bestie. 🌸

---

💀 NOTES 💀

okay this is the part where we have to be honest. r.tileset does not make "optimal" tilings (as in: as few tiles of the largest size less than the maximums). it's not out here optimising, it's out here working. 😭

this means that from latitude longitude projection to an appropriate projection for a region, in the degenerate case, it may create tiles demanding up to twice the necessary information. not me being wasteful but okay.

and furthermore — generating a tiling near a divergant point of a source projection, such as the poles of a cylindrical source projections, results in divergence of the tile set. yes, the spelling is "divergant", that's the original, we don't touch it. 🫶

not generating "optimal" tilings may have another consequence: the aspect ratio of cells in the destination region will not necessarily carry over to the source region, and generated tiles may have cells of strange aspect ratios. which, lowkey, might be a problem for some map request services presenting data in an inappropriate projection, or with strict constraints on cell aspect ratio. so like… be aware. 💅

---

📐 OUTPUT FORMAT 📐

each tile is listed on a separate line in the output. the lines are formatted as follows:

5|125|45|175|80|100

this is the default output format. it is the tile's minimum x coordinate, minimum y coordinate, maximum x coordinate, maximum y coordinate, width in cells, and height in cells, separated by the "|" character. the fields can be separated by a different character by changing the fs option. 👀

w=5;s=125;e=45;n=175;cols=80;rows=100;

this is output in a format convenient for setting variables in a shell script. slay, honestly. 🐚

bbox=5,125,45,175&width=80&height=100

this is output in a format convenient for requesting data from some http services. 🔥

---

🌈 EXAMPLES 🌈

generates tiles in latitude longitude that cover the current region — each tile will be less than 1024 cells high and 2048 cells across. the bounds and sizes of tiles in the output are separated by | (pipe):

r.tileset sourceproj=+init=epsg:4326 maxrows=1024 maxcols=2048

generates tiles in latitude longitude projection that cover the named region "ne-rio". the tiles will have 2 cells of overlap. the output format will be strings like the bbox requests for WMS servers:

r.tileset sourceproj=+init=epsg:4326 overlap=2 -w region=ne-rio

generates tiles in the coordinate reference system of the project "IrishGrid". each tile will be less than 300x400 cells in size, with 3 cells of overlap in the top and right sides of each tile. the output is in a format where each line is in shell script style. the substitution `g.proj -j project=IrishGrid` will only work in a unix style shell:

r.tileset sourceproj="`g.proj -j project=IrishGrid`" maxrows=400 maxcols=300 overlap=3 -g

---

👻 KNOWN ISSUES 👻

• r.tileset does not know about meridians that "wrap-around" in projections. it's giving oblivious. 🙈

---

👑 AUTHORS 👑

• Cedric Shock
• Updated for GRASS 7 by Martin Landa, CTU in Prague, Czech Republic

---

🧚 SOURCE CODE 🧚

Available at: r.tileset source code (history)

Latest change: Thursday May 22 03:42:15 2025 in commit: 370bcb0490b421ac90b2dbe5766af9512cb08f92

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

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

---

and that's the whole page bestie 💖 this was r.tileset(1grass) from the GRASS 8.5.0 Reference Manual, last touched Thursday May 22 03:42:15 2025 in commit 370bcb0490b421ac90b2dbe5766af9512cb08f92, © 2003-2026 GRASS Development Team. go make some tiles, you absolute icon 👑✨🎀