r.support(1grass)

📦
version 8.5.0 · 10 versions
, in alpine 3.24, ubuntu stonking

💖 r.support — the manual, but make it cute ✨

okay bestie, welcome to r.support(1grass), straight out of the GRASS User's Manual — it's the glow-up station for your raster map's ✨support files✨. let's get into it 🫶

🌸 NAME 🌸

r.support — allows creation and/or modification of raster map layer support files. it's giving metadata makeover 💅

🎀 KEYWORDS 🎀

raster, metadata

✨ SYNOPSIS ✨

r.support
r.support --help
r.support [-bsnd] map=name  [title=phrase]   [history=phrase]
[units=string]   [vdatum=string]   [source1=phrase]   [source2=phrase]
[description=phrase]   [raster=string]   [loadhistory=name]
[savehistory=name]   [semantic_label=phrase]   [--overwrite]  [--help]
[--verbose]  [--quiet]  [--ui]

🚩 Flags

  • -b — delete the semantic label. bye bye label 👋
  • -s — update statistics (histogram, range). numbers refresh moment 📊
  • -n — create/reset the null file
  • -d — delete the null file
  • --overwrite — allow output files to overwrite existing files. permission to be a lil reckless (consensually) 🔥
  • --help — print usage summary
  • --verbose — verbose module output. it WILL yap 🗣️
  • --quiet — quiet module output. shhh 🤫
  • --ui — force launching GUI dialog. for the visual girlies 🖥️

🧚 Parameters

  • map=name [required] — name of raster map. bestie you literally cannot skip this one, it's required fr fr
  • title=phrase — title for resultant raster map
  • history=phrase — text to append to the next line of the map's metadata file
  • units=string — text to use for map data units
  • vdatum=string — text to use for map vertical datum
  • source1=phrase — text to use for data source, line 1
  • source2=phrase — text to use for data source, line 2
  • description=phrase — text to use for data description or keyword(s)
  • raster=string — raster map from which to copy category table
  • loadhistory=name — text file from which to load history
  • savehistory=name — text file in which to save history
  • semantic_label=phrase — semantic label e.g. S2_8A

💜 DESCRIPTION 💜

r.support is the one that lets you create and/or edit raster map support information. editing of raster map color tables, category labels, header, history, semantic label elements and title? all supported. all valid. all iconic 👑

and yes, category labels can also be copied from another raster map. sharing is caring 💞

🛰️ Raster semantic labels and band management

the raster semantic label concept is similar to dimension name in other GIS and remote sensing applications. most common usage will be assigning a remote sensing platform sensor band identifier to the raster map metadata, although any identifier is supported (see i.band.library). raster semantic label is suggested to work with imagery classification tools. it's giving organized ✨

🌈 EXAMPLES 🌈

these examples are based on the North Carolina dataset, more specifically the landuse raster map. copy the landuse map to the current mapset:

g.copy raster=landuse,my_landuse

📊 Update statistics

r.support -s map=my_landuse

🏷️ Update Title

r.support map=my_landuse title="Landuse copied"

📜 Append to History Metadata

r.support map=my_landuse history="Copied from PERMANENT mapset"

📏 Update Units Display

r.support map=my_landuse units=meter

🎯 Set semantic label

note: landuse map doesn't confirm to CORINE specification. this is an example only.

r.support map=my_landuse semantic_label=CORINE_LULC

👀 NOTES 👀

if metadata options such as title or history are given, the module will run non-interactively. but if only the map name is given, r.support will run interactively within a terminal shell and the user with be prompted for input. choose your adventure bestie 🎢

freeform metadata information is stored in a "hist" file which may be appended to by using the history option. currently this is limited to 50 lines of text with a maximum line length of 78 characters. any input larger than this will be wrapped to the next line. all other metadata strings available as standard options are limited to 79 characters. know the limits, respect the limits 💀

🔗 SEE ALSO 🔗

i.band.library, r.category, r.describe, r.info, r.null, r.region, r.report, r.semantic.label, r.timestamp

(links? we love links. go read 'em iykyk 🫶)

👑 AUTHORS 👑

  • Micharl Shapiro, CERL: Original author
  • Brad Douglas: GRASS 6 Port
  • M. Hamish Bowman: command line enhancements
  • Markus Neteler: category copy from other map
  • Maris Nartiss: semantic label management

the legends themselves, no cap 💅

💻 SOURCE CODE 💻

available at: r.support source code (history)

latest change: Friday Feb 07 19:16:09 2025 in commit: a82a39f673b97fafcfce1604dc3e6015cb96487a

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

and that's the whole page bestie!! 💖 stay slay, keep your metadata immaculate, and remember — this was the work of the GRASS Development Team, © 2003-2026, out of the GRASS 8.5.0 Reference Manual, with the page itself being r.support(1grass) for GRASS 8.5.0. mwah 🎀✨

📦 where this page comes from