---
name: "r.semantic.label"
section: "1grass"
platform: "linux"
package: "grass-doc"
version: "8.4.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/r.semantic.label"
---

# r.semantic.label(1grass)

Manages semantic label information assigned to a single raster map or to a list of raster maps.

## NAME

**r.semantic.label**  - Manages semantic label information assigned to a single raster map or to a list of raster maps.

## KEYWORDS

general, imagery, semantic label, image collections

## SYNOPSIS

**r.semantic.label**\
 **r.semantic.label --help**\
 **r.semantic.label** **map**=*name*\[,*name*,...\]  \[**semantic\_label**=*name*\[,*name*,...\]\]  **operation**=*string*  \[--**help**\]  \[--**verbose**\]  \[--**quiet**\]  \[--**ui**\]

### Flags:

- **--help**

  Print usage summary

- **--verbose**

  Verbose module output

- **--quiet**

  Quiet module output

- **--ui**

  Force launching GUI dialog

### Parameters:

- **map**=*name\[,name*,...\] **\[required\]**

  Name of raster map(s)

- **semantic\_label**=*name\[,name*,...\]

  Name of semantic label identifier (example: S2\_1)

- **operation**=*string* **\[required\]**

  Operation to be performed\
   Options: *add, remove, print*\
   Default: *add*

## DESCRIPTION

*r.semantic.label* allows assigning a semantic label information to a single raster map or to a list of specified raster maps. Semantic label can be defined by **semantic\_label** option. Already assigned semantic label can be removed from a specified raster map by **operation=remove**. The module also allows printing detailed semantic label 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.

## NOTES

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

For more information about semantic label concept and supported sensors (generic multispectral system, Landsat-5, Landsat-7, Landsat-8, Sentinel-2) see the *i.band.library* module.

Semantic labels are supported by temporal GRASS modules. Name of STRDS can be extended by band identifier in order to filter the result by a semantic label. See *t.register*, *t.rast.list*, *t.info* and *t.rast.mapcalc* modules for examples.

## EXAMPLES

### Assign semantic label to a single raster map

```
r.semantic.label map=T33UVR_20180506T100031_B01 semantic_label=S2_1
```

### Assign semantic label to a list of raster maps

```
r.semantic.label map=T33UVR_20180506T100031_B01,T33UVR_20180521T100029_B01 semantic_label=S2_1,S2_1
```

### Assign different semantic labels to a list of raster maps

```
r.semantic.label map=T33UVR_20180506T100031_B01,T33UVR_20180506T100031_B02 semantic_label=S2_1,S2_2
```

### Remove semantic label from a list of raster maps

```
r.semantic.label map=T33UVR_20180506T100031_B01,T33UVR_20180506T100031_B02 operation=remove
```

### Print semantic label information about single raster map

```
r.semantic.label map=T33UVR_20180506T100031_B01 operation=print
```

### Print extended semantic label information for a list of raster map

```
r.semantic.label map=T33UVR_20180506T100031_B01,T33UVR_20180506T100031_B02 operation=print
```

## KNOWN ISSUES

*r.semantic.label* allows managing semantic labels only related to 2D raster maps.

## SEE ALSO

*i.band.library,* *r.info,* *r.support*

## AUTHORS

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

## SOURCE CODE

Available at: r.semantic.label source code (history)

Accessed: Monday Feb 24 17:51:45 2025

Main index \| Raster index \| Topics index \| Keywords index \| Graphical index \| Full index

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.1 Reference Manual