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