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
AUTHOR
Glynn Clements
SOURCE CODE
Available at: r.tile source code
(history)
Latest change: Thursday May 08 20:58:05 2025 in commit 4144ba8