## NAME

r.support - Allows creation and/or modification of raster map layer support files.

## KEYWORDS

raster, metadata

## SYNOPSIS

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

### Flags:

-s
  Update statistics (histogram, range)
-n
  Create/reset the null file
-d
  Delete the null file
--overwrite
  Allow output files to overwrite existing files
--help
  Print usage summary
--verbose
  Verbose module output
--quiet
  Quiet module output
--ui
  Force launching GUI dialog

### Parameters:

map=name [required]
  Name of raster map
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

## DESCRIPTION

r.support allows the user to create and/or edit raster map support information. Editing of raster map color tables, category labels, header, history, and title is supported. Category labels can also be copied from another raster map.

## EXAMPLES

These examples are based on the North Carolina dataset, more specfically 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

## NOTES

If metadata options such as title or history are given the module will run non-interactively. If only the map name is given r.support will run interactively within a terminal shell and the user with be prompted for input.

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.

## SEE ALSO

r.category, r.describe, r.info, r.null, r.region, r.report, r.timestamp

## AUTHORS

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

## SOURCE CODE

Available at: r.support source code (history)

Accessed: Friday Jun 05 19:25:37 2026

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

© 2003-2023 GRASS Development Team, GRASS GIS 7.8.8 Reference Manual