r.semantic.label(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

💖 r.semantic.label — the GRASS GIS User's Manual glow-up ✨

okay bestie, welcome to r.semantic.label from the GRASS GIS User's Manual, section 1 (that's the user commands girlies 🎀). she's all about semantic label information and she's here to help you keep your raster maps organized. no cap.

🌸 NAME 🌸

r.semantic.label — manages semantic label information assigned to a single raster map or to a list of raster maps. she's the label-maker of your dreams, fr fr. 💅

🔖 KEYWORDS 🔖

general, imagery, semantic label, image collections — iykyk.

🦋 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 — prints the usage summary, aka the lil cheat sheet. 🫶
  • --verbose — verbose module output. she talks more. she tells you things.
  • --quiet — quiet module output. she's giving mysterious, lowkey.
  • --ui — force launching the GUI dialog. main character energy, graphically.

🎀 Parameters 🎀

  • map=name[,name,...] — [required] name of the raster map(s). one map or a whole lil squad of them, your call.
  • semantic_label=name[,name,...] — name of the semantic label identifier (example: S2_1). this is the label you're stamping on 💖
  • operation=string — [required] the operation to be performed.
    • Options: add, remove, print
    • Default: add

💜 DESCRIPTION 💜

r.semantic.label allows assigning semantic label information to a single raster map or to a list of specified raster maps. the semantic label can be defined by the semantic_label option — you just tell her what to call it. 🏷️

already got a semantic label sitting there that you don't want anymore? no worries bestie, operation=remove takes it off a specified raster map. clean slate, periodt.

and if you just wanna look at what's already been assigned? the module also lets you print detailed semantic label information already assigned to a raster map by using operation=print. she's transparent, she's honest, she's everything. 💅

oh and also — either a single raster map or a list of raster maps can be given by the map option. flexible queen. 🌈

📝 NOTES 📝

heads up babes: only raster maps from the current mapsets can be modified. that's the vibe check. if it's not in your current mapset, she can't touch it. 😭

for more information about the semantic label concept and the supported sensors (generic multispectral system, Landsat-5, Landsat-7, Landsat-8, Sentinel-2) — go peek at the i.band.library module. she's the lore keeper. 📚✨

semantic labels are supported by temporal GRASS modules. the name of a STRDS can be extended by a 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 — they're all serving looks. 👑

🍓 EXAMPLES 🍓

🌟 Assign semantic label to a single raster map

r.semantic.label map=T33UVR_20180506T100031_B01 semantic_label=S2_1

one map, one label. simple. elegant. iconic.

🌟 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

two maps, both get S2_1. matching outfits, we love to see it. 🫶

🌟 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

now they're individuals. S2_1 and S2_2, each living her own truth. 💖

🌟 Remove semantic label from a list of raster maps

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

bye bye labels 👋 it's giving fresh start.

r.semantic.label map=T33UVR_20180506T100031_B01 operation=print

just one map's receipts, please.

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

the full extended tea ☕ for the whole list. obsessed.

💀 KNOWN ISSUES 💀

r.semantic.label allows managing semantic labels only related to 2D raster maps. so like, 2D only, bestie. that's the limit. don't come at her with 3D, she will simply not. 🙈

👀 SEE ALSO 👀

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

go say hi, they're all in the friend group. 🌸

👑 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: Saturday Jan 17 05:41:52 2026

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

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual 🎀

and that's the whole page, bestie — brought to you by GRASS 8.4.2, r.semantic.label(1), accessed Saturday Jan 17 05:41:52 2026. go label something. slay. 💅✨🦋

📦 where this page comes from