---
name: "r.tile"
section: "1grass"
platform: "linux"
package: "grass-doc"
version: "8.4.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/r.tile"
---

# r.tile(1grass)

Splits a raster map into tiles.

## NAME

**r.tile**  - Splits a raster map into tiles.

## 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**

  Print usage summary

- **--verbose**

  Verbose module output

- **--quiet**

  Quiet module output

- **--ui**

  Force launching GUI dialog

### Parameters:

- **input**=*name* **\[required\]**

  Name of input raster map

- **output**=*string* **\[required\]**

  Output base name

- **width**=*integer* **\[required\]**

  Width of tiles (columns)

- **height**=*integer* **\[required\]**

  Height of tiles (rows)

- **overlap**=*integer*

  Overlap of tiles

## DESCRIPTION

*r.tile* retiles an existing raster map with user defined x and y tile size.

## NOTES

*r.tile* generates a separate raster for each tile. This is equivalent to running *g.region* along with *r.resample* in a double loop.

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.

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, ...).

## SEE ALSO

*g.region,* *r3.retile*

## AUTHOR

Glynn Clements

## SOURCE CODE

Available at: r.tile source code (history)

Accessed: Monday Feb 24 17:50:55 2025

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

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.1 Reference Manual