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
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)
Latest change: Friday Feb 07 19:16:09 2025 in commit a82a39f