GRASS logo


t.rast.patch - Patches multiple space time raster maps into a single raster map using r.patch.


temporal, aggregation, series, raster, merge, patching, time


t.rast.patch --help
t.rast.patch [-tzsv] input=name [where=sql_query] output=name [sort=string] [--overwrite] [--help] [--verbose] [--quiet] [--ui]


Do not assign the space time raster dataset start and end time to the output map
Use zero (0) for transparency instead of NULL
Do not create color and category files
Patch to virtual raster map (r.buildvrt)
Allow output files to overwrite existing files
Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog


input=name [required]
Name of the input space time raster dataset
WHERE conditions of SQL statement without 'where' keyword used in the temporal GIS framework
Example: start_time > '2001-01-01 12:30:00'
output=name [required]
Name for output raster map
Sort order (see sort parameter)
Options: asc, desc
Default: desc

Table of contents


This module patches raster maps that have gaps in time with subsequent maps (within a space time raster dataset) using r.patch or r.buildvrt. Hence it is a wrapper for those two modules in the temporal domain.

By default r.patch is used to create a patched raster map. Especially for temporary data, using r.buildvrt for patching can be advantageous with regards to processing time and storage space. r.buildvrt creates a virtual raser map and is used when the v-flag is given. The v-flag excludes the z-flag (using zero (0) for transperancy) and s-flag (do not create color and category files).

The input of this module is a single space time raster dataset, the output is a single raster map layer. A subset of the input space time raster dataset can be selected using the where option. The sorting of the raster map layer can be set using the sort option. Be aware that the sorting of the maps significantly influences the result of the patch. By default the maps are sorted by desc by the start_time so that the newest raster map is the first input map in r.patch/r.buildvrt.

Please note that the color table of the first input raster is used for the resulting map when the v-flag is used. Values in the resulting raster map that exeed the range of that first raster map will then be rendered on the screen like no data. In that case, please update the color table or the resulting map with r.colors

t.rast.patch is a simple wrapper for the raster module r.patch or r.buildvrt.


The example uses the North Carolina extra time series of MODIS Land Surface Temperature maps (download). (The mapset has to be unzip in one of the North Carolina locations.)

Patching the MODIS Land Surface Temperature for 2016 (filling missing pixels by subsequent maps in the time series):

t.rast.patch input=LST_Day_monthly@modis_lst output=LST_Day_patched_2016 \
  where="start_time >= '2016-01' and start_time <= '2016-12'" LST_Day_patched_2016

Patching the MODIS Land Surface Temperature for 2016 (filling missing pixels by subsequent maps in the time series) using a virtual mosaic (r.buildvrt):

t.rast.patch -v input=LST_Day_monthly@modis_lst output=LST_Day_patched_2016_vrt \
  where="start_time >= '2016-01' and start_time <= '2016-12'"
# Assign a new color table that covers the entire range of the resulting map
r.colors map=LST_Day_patched_2016_vrt color=grey LST_Day_patched_2016_vrt


r.buildvrt, r.patch, t.rast.series, t.create,, t.merge

Temporal data processing Wiki


Anika Bettge, mundialis GmbH & Co. KG


Available at: t.rast.patch source code (history)

Latest change: Tuesday Mar 26 20:41:36 2024 in commit: 3b09b1d78f6e96ffebacac6e36f0afd91ad0c091

Main index | Temporal index | Topics index | Keywords index | Graphical index | Full index

© 2003-2024 GRASS Development Team, GRASS GIS 8.3.3dev Reference Manual