t.rast.bandcalc - GRASS manual

NAME

t.rast.bandcalc - Performs spatio-temporal mapcalc expressions using different bands in a given STRDS.

KEYWORDS

SYNOPSIS

t.rast.bandcalc

t.rast.bandcalc --help

t.rast.bandcalc [-ns] input=name expression=string [method=name[,name,...]] output=name basename=basename [nprocs=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-n: Register Null maps
-s: Check the spatial topology of temporally related maps and process only spatially related maps
--overwrite: Allow output files to overwrite existing files
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

input=name [required]: Name of the input space time raster dataset
expression=string [required]: Spatio-temporal mapcalc expression
method=name[,name,...]: The method to be used for sampling the input dataset; Options: start, during, overlap, contain, equal, follows, precedes; Default: equal
output=name [required]: Name of the output space time raster dataset
basename=basename [required]: Basename for output raster maps; A numerical suffix separated by an underscore will be attached to create a unique identifier
nprocs=integer: Number of r.mapcalc processes to run in parallel; Default: 1

DESCRIPTION
SEE ALSO
AUTHOR

DESCRIPTION

t.rast.bandcalc performs a spatio-temporal mapcalc expression on maps of temporally sampled space time raster datasets (STRDS). It uses a single STRDS as input and calculates a new STRDS according to expression from different bands included in the input STRDS. This is useful to e.g. calculcate a time-series of NDVI or EVI maps, or any other indices based on several different input bands.

This module is a front-end for t.rast.mapcalc.

Different bands must be referenced in the expression by data[index] with index being a number starting with 0. For example, with Sentinel-2, data[3] refers to the fourth Sentinel-2 band "S2_4 Visible (Red)". t.rast.bandcalc replaces data[index] with the according selections of the input STRDS.

This module expects several parameters. The resulting space time raster dataset must be specified in the output option together with the basename of generated raster maps that are registered in the resulting STRDS. Empty maps resulting from map-calculation are not registered by default. This behavior can be changed with the -n flag. The flag -s can be used to assure that only spatially related maps in the STRDS's are processed. Spatially related means that temporaly related maps overlap in their spatial extent.

AUTHOR

Markus Metz, mundialis, Germany

SOURCE CODE

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

Accessed: Monday Jul 27 12:30:23 2026