xenial (1) d.colortable.1grass.gz

NAME

       d.colortable  - Displays the color table associated with a raster map layer.

KEYWORDS

       display, raster, color table

SYNOPSIS

       d.colortable
       d.colortable --help
       d.colortable  [-n]  map=name   [color=name]   [lines=integer]   [columns=integer]   [--help]  [--verbose]
       [--quiet]  [--ui]

   Flags:
       -n
           Do not draw a collar showing the NULL color in FP maps

       --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 whose color table is to be displayed

       color=name
           Color of lines separating the colors of the color table
           Either a standard color name or R:G:B triplet
           Default: white

       lines=integer
           Number of lines to appear in the color table
           Options: 1-1000

       columns=integer
           Number of columns to appear in the color table
           Options: 1-1000

DESCRIPTION

       d.colortable is used to display the color table associated with a raster map in the active frame  on  the
       graphics monitor. The map name should be an available raster map in the user’s current mapset search path
       and location.

       If the values of both lines and columns are not specified by the user, d.colortable  divides  the  active
       frame equally among the number of categories present in the named raster map. If one option is specified,
       the other is automatically set to accommodate all categories.  If both are specified, as many  categories
       as possible are displayed.

       If  the  user  specifies  the  name of a map on the command line but does not specify the values of other
       parameters, parameter default values will be used.  Alternately, if the user types simply d.colortable on
       the  command  line without any program arguments, the program will prompt the user for parameter settings
       using the standard GRASS parser interface.

EXAMPLE

       The user running the command:
       d.colortable map=soils color=red lines=1 columns=3
       would see the active graphics frame divided into three columns extending the full frame height. The lines
       dividing  the color table associated with the soils map would be displayed in red. The user would see, at
       most, only three of the colors from the soils color table displayed in the active frame (because the user
       requested that this frame be divided into three sections).

NOTES

       If  the  user  wishes  to  display  the  entire color table associated with a map, the user should either
       stipulate a number of lines (rows) and columns (cols) sufficient to accommodate the number of  categories
       in  the  map’s color table, or fail to assign values to one or both of lines and/or columns.  If the user
       runs d.colortable using the default number of lines and columns (the full graphics frame), all categories
       from  the  map’s  color  table  will  be  displayed.  However,  if the user requests that the color table
       associated with a map which has 10 data categories be displayed in a graphics frame  with  only  3  lines
       (rows) and 2 columns (a total of six cells), only six of the ten map categories will be displayed.

       The user should run d.erase between runs of d.colortable to avoid confusion.

SEE ALSO

        d.erase, d.legend, d.rast

AUTHOR

       James Westervelt, U.S. Army Construction Engineering Research Laboratory

       Last changed: $Date: 2015-02-02 09:13:36 +0100 (Mon, 02 Feb 2015) $

       Main index | Display index | Topics index | Keywords index | Full index

       © 2003-2016 GRASS Development Team, GRASS GIS 7.0.3 Reference Manual