NAME

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

KEYWORDS

       display, raster

SYNOPSIS

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

   Flags:
       -n
           Don't draw a collar showing the NULL color in FP maps

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       map=name
           Name of raster map whose color table is to be displayed

       color=string
           Color of lines separating the colors of the color table
           Options:
           red,orange,yellow,green,blue,indigo,violet,white,black,gray,brown,magenta,aqua,grey,cyan,purple
           Default: white

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

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

DESCRIPTION

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

       If  the  values  of  both  lines and cols are not specified by  the user, d.colortable divides the active
       frame equally among the number of categories present in the named raster map  layer.  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 cols=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 cols.  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 the GRASS program d.erase between runs of d.colortable to avoid confusion.

SEE ALSO

        d.colors
       d.erase
       d.legend
       d.rast

AUTHOR

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

       Last changed: $Date: 2011-11-08 03:29:50 -0800 (Tue, 08 Nov 2011) $

       Full index

       © 2003-2013 GRASS Development Team

GRASS 6.4.3                                                                                 d.colortable(1grass)