Skip to content

r.tile

Splits a raster map into tiles.

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

Example:

r.tile input=name output=string width=integer height=integer

grass.script.run_command("r.tile", input, output, width, height, overlap=None, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("r.tile", input="name", output="string", width=integer, height=integer)

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
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

input : str, required
    Name of input raster map
    Used as: input, raster, name
output : str, required
    Output base name
width : int, required
    Width of tiles (columns)
height : int, required
    Height of tiles (rows)
overlap : int, optional
    Overlap of tiles
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

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)
Latest change: Thursday May 08 20:58:05 2025 in commit 4144ba8