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



NNAAMMEE
       ii..ggrroouupp	 -  An	imagery  function  that creates and edits
       groups and subgroups of (raster) imagery files.
       _(_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..ggrroouupp

DDEESSCCRRIIPPTTIIOONN
       _i_._g_r_o_u_p allows the user to collect raster map layers in an
       imagery group by assigning them to user-named subgroups or
       other groups. This enables the user to run analyses on any
       combination of the raster map layers in a group.  The user
       creates the groups and subgroups and  selects  the  raster
       map  layers  that  are to reside in them. Imagery analysis
       programs like _i_._r_e_c_t_i_f_y, _i_._o_r_t_h_o_._r_e_c_t_i_f_y  and  others  ask
       the  user  for the name of an imagery group whose data are
       to be analyzed. Imagery analysis  programs  like  _i_._m_a_x_l_i_k
       ask  the  user  for the imagery group and imagery subgroup
       whose data are to be analyzed.


       The interactive mode provides extended functionality.


       The first menu if the interactive mode in the _i_._g_r_o_u_p pro-
       gram  asks  the user to select a _g_r_o_u_p.	If the group does
       not exist, the user will be asked if he or she would  like
       to create a new group.

       This program edits imagery groups. You may add raster map
       layers to, or remove such layers from, an imagery group.
       You may also create new groups.
	      Please enter the group to be created/modified

	 GROUP: _____________ (enter 'list' for a list of groups)


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

       If the word _l_i_s_t is entered, groups that have already been
       created	in the user's current LOCATION_NAME and MAPSET(S)
       will be listed.	The second menu in _i_._g_r_o_u_p  provides  the
       user with the following options:

	    1.	  Select a different group
	    2.	  Edit group TITLE
	    3.	  Include new raster (cell) files in the group
		  or remove raster (cell) files from the group
	    4.	  Assign colors to the group
	    5.	  Create a new subgroup within the group

		  RETURN to exit



       The options are described as follows:

	      _S_e_l_e_c_t _a _d_i_f_f_e_r_e_n_t _g_r_o_u_p
	      If option number 1 is chosen, the following menu is
	      displayed:

		   Please enter the group to be created/modified

	      GROUP: _____________ (enter 'list' for  a  list  of
	      groups)


		AFTER  COMPLETING  ALL ANSWERS, HIT <ESC> TO CON-
	      TINUE
			       (OR <Ctrl-C> TO EXIT)

	      If the word  _l_i_s_t  is  entered,  groups  that  have
	      already  been  created in the current LOCATION_NAME
	      and MAPSET(S) will be displayed.



	      _E_d_i_t _g_r_o_u_p _T_I_T_L_E
	      If option number 2 is selected, an entry	space  is
	      provided to type in the group TITLE.  This TITLE is
	      useful in identifying each group:

		   TITLE______________________________________


	      This option offers an opportunity to  go	back  and
	      change
	      the  entry if it is not correct by asking: Look ok?
	      (y/n).


	      _I_n_c_l_u_d_e _n_e_w _r_a_s_t_e_r _(_c_e_l_l_) _f_i_l_e_s  _i_n  _t_h_e	_g_r_o_u_p  _o_r
	      _r_e_m_o_v_e _r_a_s_t_e_r _(_c_e_l_l_) _f_i_l_e_s _f_r_o_m _t_h_e _g_r_o_u_p
	      When  choosing  option number 3, the following menu
	      is displayed:

		  LOCATION: location   GROUP: spot   MAPSET: demo

	      If  you  wish  to  delete a file from group [spot],
	      remove
	      the 'x' from in front of the file name.

			       x_    spot.1 in demo
			       x_    spot.2 in demo
			       x_    spot.3 in demo


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

	      Next,a menu listing all the other raster map layers
	      present in the current MAPSET(S) will be displayed:

	       LOCATION:  location	 GROUP: spot	  MAPSET:
	      demo

	      Please mark an 'x' by the files to be added in
	      group [spot]

				   MAPSET: demo

				  x_   composite1
				  x_   spotclass1
				  __   spotclass2

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

	      If  more	than  one  MAPSET  is selected, menus for
	      those mapsets will also be displayed.   All  raster
	      map layers selected with an 'x' will be included in
	      the group being updated.


       The user will then have the opportunity to check the  con-
       tents of the group that was just modified:

	Group [spot] references the following raster files

			 __________________
			spot.1	     in demo
			spot.2	     in demo
			spot.3	     in demo
			composite1   in demo
			spotclass1   in demo
			 __________________
			   Look ok? (y/n)

       If  the user responds with the letter _y then the following
       sentence is displayed on the screen:

       Group [spot] updated!

       And the main menu for _i_._g_r_o_u_p returns.


       If the user responds _n,	the  menu  containing  the  group
       files after it was modified will be displayed and the user
       will be asked to place an _x in front of those  raster  map
       layers  that  are  to  be removed from the group.  Then, a
       menu listing all of the other raster  map  layers  in  the
       current	MAPSET will be displayed again, and the user will
       be again asked to place an _x in front of raster map layers
       to  be  included  in  the  group.  This gives the user the
       opportunity to correct mistakes or  make  changes  in  the
       choice  of  raster  map	layers	to be selected in a group
       without exiting _i_._g_r_o_u_p.

	      _A_s_s_i_g_n _c_o_l_o_r_s _t_o _t_h_e _g_r_o_u_p
	      Option number 4 provides the following menu:

	      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
				 ___	composite1
				 ___	spotclass1

		     <<<; r,g,b can only be specified once >>>;

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

	      This  menu  allows  you  to select a color for each
	      imagery band or for each file for  display.   Note,
	      however,	 that  composite  images  and  classified
	      images are already  assigned  colors  during  their
	      creation.


       An  opportunity	to change the choice of colors is offered
       after escaping the menu by:

       Look ok? (y/n)


	      _C_r_e_a_t_e _a _n_e_w _s_u_b_g_r_o_u_p _w_i_t_h_i_n _t_h_e _g_r_o_u_p

	      The following menu enables the  user  to	create	a
	      subgroup	out of any combination of raster map lay-
	      ers in the group.  Any number of subgroups  may  be
	      created by repeating the option.

		  LOCATION: location		    MAPSET: spot

	      GROUP: spot1
	      SUBGROUP: ___________ ('list' will show available
	      subgroups)

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

	      After selecting or creating a subgroup,  this  menu
	      is displayed:

		  Mark an 'x' by the files to form subgroup [123]

				 x_    spot.1
				 x_    spot.2
				 x_    spot.3
				 __    composite1
				 __    spotclass1

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

	      The user is then given the opportunity to check the
	      contents of the subgroup:

	      Subgroup [123] references the following raster
	      (cell) files

				__________________
				 spot.1   in demo
				 spot.2   in demo
				 spot.3   in demo
				__________________
				  Look ok? (y/n)

	      If the user responds with the letter _n,  the  group
	      menu  will appear again enabling the user to select
	      raster map layers to form the subgroup.


NNOOTTEESS
       The _i_._g_r_o_u_p options are only  available	for  imagery  map
       layers in the current LOCATION_NAME.


       Subgroup names may not contain more than 12 characters.


       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


       _i_._c_l_u_s_t_e_r

       _i_._m_a_x_l_i_k

       _i_._p_o_i_n_t_s

       _i_._r_e_c_t_i_f_y

AAUUTTHHOORR
       Michael	 Shapiro,   U.S.Army   Construction   Engineering
       Research Laboratory
       Parser support: Bob Covill (Tekmap, Canada)

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_3_/_0_1 _0_0_:_2_7_:_4_5 _$



GRASS 5.0					       i.group(1)
