Geografic-Information-System/scripts/r.semantic.label/r.semantic.label.html

<h2>DESCRIPTION</h2>

<em>r.semantic.label</em> 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 <b>semantic_label</b> option. Already assigned semantic
label can be removed from a specified raster map
by <b>operation=remove</b>. The module also allows printing detailed
semantic label information already assigned to a raster map
by <b>operation=print</b>.

<p>
Either a single raster map or a list of raster maps can be given
by <b>map</b> option.

<h2>NOTES</h2>

Note that <i>only raster maps from the current mapsets</i> can be modified.

<p>
For more information about semantic label concept and supported sensors
(generic multispectral system, Landsat-5, Landsat-7, Landsat-8, Sentinel-2)
see the <em><a href="i.band.library.html">i.band.library</a></em> module.

<p>
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
<em><a href="t.register.html#support-for-band-references">t.register</a></em>,
<em><a href="t.rast.list.html#filtering-the-result-by-band-references">t.rast.list</a></em>,
<em><a href="t.info.html#space-time-dataset-with-band-references-assigned">t.info</a></em>
and <em><a href="t.rast.mapcalc.html#band-reference-filtering">t.rast.mapcalc</a></em>
modules for examples.

<h2>EXAMPLES</h2>

<h3>Assign semantic label to a single raster map</h3>

<div class="code"><pre>
r.semantic.label map=T33UVR_20180506T100031_B01 semantic_label=S2_1
</pre></div>

<h3>Assign semantic label to a list of raster maps</h3>

<div class="code"><pre>
r.semantic.label map=T33UVR_20180506T100031_B01,T33UVR_20180521T100029_B01 semantic_label=S2_1,S2_1
</pre></div>

<h3>Assign different semantic labels to a list of raster maps</h3>

<div class="code"><pre>
r.semantic.label map=T33UVR_20180506T100031_B01,T33UVR_20180506T100031_B02 semantic_label=S2_1,S2_2
</pre></div>

<h3>Remove semantic label from a list of raster maps</h3>

<div class="code"><pre>
r.semantic.label map=T33UVR_20180506T100031_B01,T33UVR_20180506T100031_B02 operation=remove
</pre></div>

<h3>Print semantic label information about single raster map</h3>

<div class="code"><pre>
r.semantic.label map=T33UVR_20180506T100031_B01 operation=print
</pre></div>

<h3>Print extended semantic label information for a list of raster map</h3>

<div class="code"><pre>
r.semantic.label map=T33UVR_20180506T100031_B01,T33UVR_20180506T100031_B02 operation=print
</pre></div>

<h2>KNOWN ISSUES</h2>

<em>r.semantic.label</em> allows managing semantic labels only related to 2D
raster maps.

<h2>SEE ALSO</h2>

<em>
  <a href="i.band.library.html">i.band.library</a>,
  <a href="r.info.html">r.info</a>,
  <a href="r.support">r.support</a>
</em>

<h2>AUTHORS</h2>

Martin Landa<br>
Development sponsored by <a href="https://www.mundialis.de/en">mundialis
GmbH &amp; Co. KG</a> (for the <a href="https://openeo.org">openEO</a>
EU H2020 grant 776242)