GRASS logo

NAME - Manages band reference information assigned to a single raster map or to a list of raster maps.


general, imagery, band reference, image collections

SYNOPSIS --help map=name[,name,...] [band=name[,name,...]] operation=string [--help] [--verbose] [--quiet] [--ui]


Print usage summary
Verbose module output
Quiet module output
Force launching GUI dialog


map=name[,name,...] [required]
Name of raster map(s)
Name of band reference identifier (example: S2_1)
operation=string [required]
Operation to be performed
Options: add, remove, print
Default: add

Table of contents

DESCRIPTION allows assigning a band reference information to a single raster map or to a list of specified raster maps. Band reference can be defined by band option. Already assigned band reference can be removed from a specified raster map by operation=remove. The module also allows printing detailed band reference information already assigned to a raster map by operation=print.

Either a single raster map or a list of raster maps can be given by map option.


Note that only raster maps from the current mapsets can be modified.

For more information about band reference concept and supported sensors (generic multispectral system, Landsat-5, Landsat-7, Landsat-8, Sentinel-2) see the g.bands module.

Band references are supported by temporal GRASS modules. Name of STRDS can be extended by band identifier in order to filter the result by a band reference. See t.register, t.rast.list, and t.rast.mapcalc modules for examples.


Assign band reference to a single raster map map=T33UVR_20180506T100031_B01 band=S2_1

Assign band reference to a list of raster maps map=T33UVR_20180506T100031_B01,T33UVR_20180521T100029_B01 band=S2_1,S2_1

Assign different band references to a list of raster maps map=T33UVR_20180506T100031_B01,T33UVR_20180506T100031_B02 band=S2_1,S2_2

Remove band reference from a list of raster maps map=T33UVR_20180506T100031_B01,T33UVR_20180506T100031_B02 operation=remove

Print band reference information about single raster map map=T33UVR_20180506T100031_B01 operation=print

Print extended band reference information for a list of raster map map=T33UVR_20180506T100031_B01,T33UVR_20180506T100031_B02 operation=print

KNOWN ISSUES allows managing band references only related to 2D raster maps.




Martin Landa
Development sponsored by mundialis GmbH & Co. KG (for the openEO EU H2020 grant 776242)


Available at: source code (history)

Main index | Imagery index | Topics index | Keywords index | Graphical index | Full index

© 2003-2021 GRASS Development Team, GRASS GIS Reference Manual