d.colortable(1)        Grass User's Manual	  d.colortable(1)



NNAAMMEE
       dd..ccoolloorrttaabbllee  - To display the color table associated with
       a raster map layer.
       _(_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       dd..ccoolloorrttaabbllee
       dd..ccoolloorrttaabbllee hheellpp
       dd..ccoolloorrttaabbllee    mmaapp==_n_a_m_e    [ccoolloorr==_n_a_m_e]     [lliinneess==_v_a_l_u_e]
       [ccoollss==_v_a_l_u_e]

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



   PPaarraammeetteerrss::
       mmaapp==_n_a_m_e
	      Name  of	a  raster map layer in the user's current
	      mapset search path whose color table is to be  dis-
	      played.

       ccoolloorr==_n_a_m_e
	      Color  of  the  lines  separating the colors of the
	      color table.
	      Options: red, orange, yellow, green, blue,  indigo,
	      violet, gray, white, and black.
	      Default: _w_h_i_t_e

       lliinneess==_v_a_l_u_e
	      Number of lines to appear in the color table.
	      Options: 1 - 1000

       ccoollss==_v_a_l_u_e
	      Number of columns to appear in the color table.
	      Options:	1  - 1000 If the _v_a_l_u_es of both _l_i_n_e_s and
	      _c_o_l_s are not specified by  the  user,  _d_._c_o_l_o_r_t_a_b_l_e
	      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 possi-
	      ble are displayed.



       The user can specify all needed parameters on the  command
       line using the form:


       dd..ccoolloorrttaabbllee	mmaapp==_n_a_m_e    [ccoolloorr==_n_a_m_e]    [lliinneess==_v_a_l_u_e]
       [ccoollss==_v_a_l_u_e]



       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  dd..ccoolloorrttaabbllee on the command line
       without any program arguments, the program will prompt the
       user  for  parameter  settings  using  the  standard GRASS
       parser interface described in the manual entry for _p_a_r_s_e_r.

EEXXAAMMPPLLEE
       The  user  running  the	command:  dd..ccoolloorrttaabbllee	mmaapp==_s_o_i_l_s
       [ccoolloorr==_r_e_d] [lliinneess==_1] [ccoollss==_3]

       would see the active graphics  frame  divided  into  three
       columns	extending the full frame height. The lines divid-
       ing the color table associated with the _s_o_i_l_s map would be
       displayed in red.  The user would see, at most, only three
       of the colors from the _s_o_i_l_s color table displayed in  the
       active  frame  (because the user requested that this frame
       be divided into three sections).

NNOOTTEESS
       If the user wishes to display the entire color table asso-
       ciated with a map, the user should either stipulate a num-
       ber 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  _l_i_n_e_s
       and/or  _c_o_l_s.   If  the	user  runs _d_._c_o_l_o_r_t_a_b_l_e 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  command  dd..ccoolloorrmmooddee  mmooddee==float
       before  running	_d_._c_o_l_o_r_t_a_b_l_e, for accurate display of the
       map's color table.


       The user should run the GRASS program _d_._e_r_a_s_e between runs
       of _d_._c_o_l_o_r_t_a_b_l_e to avoid confusion.

SSEEEE AALLSSOO
       _d_._c_o_l_o_r_m_o_d_e

       _d_._c_o_l_o_r_s

       _d_._d_i_s_p_l_a_y

       _d_._e_r_a_s_e

       _d_._r_a_s_t

       _p_a_r_s_e_r

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

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_2 _$



GRASS 5.0					  d.colortable(1)
