Skip to content

r.semantic.label

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

r.semantic.label map=name [,name,...] [semantic_label=name [,name,...]] operation=string [--verbose] [--quiet] [--qq] [--ui]

Example:

r.semantic.label map=name operation=add

grass.script.run_command("r.semantic.label", map, semantic_label=None, operation="add", verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("r.semantic.label", map="name", operation="add")

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
    Allowed values: add, remove, print
    Default: add
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

map : str | list[str], required
    Name of raster map(s)
    Used as: input, raster, name
semantic_label : str | list[str], optional
    Name of semantic label identifier (example: S2_1)
    Used as: name
operation : str, required
    Operation to be performed
    Allowed values: add, remove, print
    Default: add
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

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
r.semantic.label map=T33UVR_20180506T100031_B01 operation=print
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)
Latest change: Friday Feb 07 19:16:09 2025 in commit a82a39f