i.composite(1)	       Grass User's Manual	   i.composite(1)



NNAAMMEE
       ii..ccoommppoossiittee   -	An  imagery function that creates a color
       composite image from three imagery band files specified by
       the user.
       _(_G_R_A_S_S _I_m_a_g_e _P_r_o_c_e_s_s_i_n_g _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       ii..ccoommppoossiittee

DDEESSCCRRIIPPTTIIOONN
       _i_._c_o_m_p_o_s_i_t_e  creates  a	color  composite image from three
       band files specified by the user.  The user specifies  the
       bands  to  be  used by assigning a red, blue, and/or green
       color to each band.  The resulting image is a  raster  map
       layer  of  raw  spectral  data composed of the three bands
       chosen by the user.  The color composite can then be  dis-
       played,	painted,  or  manipulated as would any raster map
       layer in GRASS.


       The first prompt asks the user for the imagery group whose
       files are to be used.


       The following menu is then displayed:

       Please  indicate  which	files  to use for red, green, and
       blue
       colors.	You may leave any color  out.	You  may  specify
       more
       than one color per file.  However, each color may only be
       specified once.	For example, to get a full color image,
       specify r,g,b for 3 different files.  To get a grey scale
       image, specify rgb for a single file.

			    b__    spot.1
			    g__    spot.2
			    r__    spot.3
			    ___    spotclass
			    ___    spotreject

	   AFTER COMPLETING ALL ANSWERS, HIT <ESC> TO CONTINUE
			 (OR <Ctrl-C> TO CANCEL)

       The user is then allowed to check the choice of bands:

		      Colors assigned as follows:

			RED:	 spot.3@mapsetname
			GREEN:	 spot.2@mapsetname
			BLUE:	 spot.1@mapsetname

			    Look ok? (y/n) [y]

		      How  many  color levels (number of colors =
       levels^3)? 10

       If the number of color levels is  set  to  10,  the  color
       table  that is created has 1000 colors (10 saturation lev-
       els (or shades) per primary  color  (blue,  green,  red)).
       The  number of colors that can be displayed at one time on
       a color graphics  monitor  will	depend	on  the  graphics
       monitor being used. Note that GRASS currently becomes very
       slow in displaying maps with more than 8000 colors  (color
       level: 20). So 10 to 15 color levels are recommended.


       The  user is then asked to name the composite image raster
       map layer.  The percentage  completed  is  echoed  to  the
       screen and _r_._s_u_p_p_o_r_t files are created automatically.

NNOOTTEESS
       The  user  should  always check the geographic region set-
       tings before running most imagery commands.   It  is  very
       easy  for  the  boundaries  of the geographic region to be
       completely off the image.  Before running _i_._c_o_m_p_o_s_i_t_e,  or
       other  imagery  commands, the user should probably set the
       geographic region to match that of the raster  map  layers
       to  be  read.   This can be accomplished using option 4 of
       the _g_._r_e_g_i_o_n command.


       This program is interactive and requires no  command  line
       arguments.

SSEEEE AALLSSOO
       _G_R_A_S_S _T_u_t_o_r_i_a_l_: _I_m_a_g_e _P_r_o_c_e_s_s_i_n_g


       _d_._h_i_s

       _d_._r_g_b

       _d_._r_a_s_t

       _g_._r_e_g_i_o_n

       _i_._c_o_l_o_r_s

       _i_._g_r_o_u_p

       _r_._c_o_l_o_r_s

       _r_._s_u_p_p_o_r_t

AAUUTTHHOORR
       Michael	 Shapiro,   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_3 _$



GRASS 5.0					   i.composite(1)
