g.mapsets(1)		      Grass User's Manual		  g.mapsets(1)



NNAAMMEE
       gg..mmaappsseettss   - Modifies the user's current mapset search path, affecting
       the user's access to data existing under the other GRASS mapsets in the
       current location.
       _(_G_R_A_S_S _F_i_l_e _M_a_n_a_g_e_m_e_n_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       gg..mmaappsseettss
       gg..mmaappsseettss hheellpp
       gg..mmaappsseettss [--llpp] [mmaappsseett==_n_a_m_e[,_n_a_m_e,...]]  [aaddddmmaappsseett==_n_a_m_e[,_n_a_m_e,...]]

DDEESSCCRRIIPPTTIIOONN
       A _m_a_p_s_e_t holds a distinct set of data layers, each relevant to the same
       (or a subset of the same) geographic region, and each drawn in the same
       map  coordinate system.	At the outset of every GRASS session, the user
       identifies a GRASS data base, location, and mapset that are to  be  the
       user's  _c_u_r_r_e_n_t _d_a_t_a _b_a_s_e, _c_u_r_r_e_n_t _l_o_c_a_t_i_o_n, and _c_u_r_r_e_n_t _m_a_p_s_e_t for the
       duration of the session; any maps created by the user during  the  ses-
       sion  will be stored under the _c_u_r_r_e_n_t _m_a_p_s_e_t ($MAPSET) set at the ses-
       sion's outset.


       The user can add, modify, and delete data layers that exist  under  his
       _c_u_r_r_e_n_t	_m_a_p_s_e_t.   Although  the  user can also _a_c_c_e_s_s (i.e., use) data
       that are stored under _o_t_h_e_r mapsets in the  same  GRASS	location,  the
       user can only make permanent changes (create or modify data) located in
       the _c_u_r_r_e_n_t _m_a_p_s_e_t.  The user's _m_a_p_s_e_t _s_e_a_r_c_h _p_a_t_h lists the  order  in
       which  other  mapsets  in  the  same GRASS location can be searched and
       their data accessed by the user.  The user can modify the  listing  and
       order  in  which  these	mapsets  are  accessed by modifying the mapset
       search path; this can be done using the _g_._m_a_p_s_e_t_s command.   This  pro-
       gram  allows the user to use other's relevant map data without altering
       the original data layer, and without taking up disk space with  a  copy
       of the original map.


       _g_._m_a_p_s_e_t_s  shows  the  user  available  mapsets under the current GRASS
       location, lists mapsets to which the user  currently  has  access,  and
       lists  the  order in which accessible mapsets will be accessed by GRASS
       programs searching for data files.  The user is then given the opportu-
       nity  to add or delete mapset names from his search path, or modify the
       order in which mapsets will be accessed.


       When the user specifies the name of a data base element file  (e.g.,  a
       particular  vector  file,  raster file, imagery group file, etc.)  to a
       GRASS program, the program searches for the named file  under  each  of
       the mapsets listed in the user's mapset search path in the order listed
       there until the program finds a file of the  given  name.   (Users  can
       also  specify  a  file  by its mapset, to make explicit the mapset from
       which  the  file  is  to  be  drawn;    e.g.,   the   command:	gg..ccooppyy
       rraasstt==_'_s_o_i_l_s_._f_i_l_e_@_P_E_R_M_A_N_E_N_T_'_,_m_y_._s_o_i_l_s

       ensures	that  a  new  file  named _m_y_._s_o_i_l_s is to be a copy of the file
       _s_o_i_l_s_._f_i_l_e from the mapset PERMANENT.)


       It is common for a user to have the special mapset  PPEERRMMAANNEENNTT  included
       in  his	mapset search path, as this mapset typically contains finished
       base maps relevant to many applications.  Often,  other	mapsets  which
       contain sets of interpreted map layers will be likewise included in the
       user's mapset search path.   Suppose,  for  example,  that  the	mapset
       _S_o_i_l___M_a_p_s contains interpreted soils map layers to which the user wants
       access.	The mapset _S_o_i_l___M_a_p_s should then be  included  in  the	user's
       _s_e_a_r_c_h _p_a_t_h variable.


       The  _m_a_p_s_e_t  _s_e_a_r_c_h  _p_a_t_h is saved as part of the current mapset.  When
       the user works with that mapset in subsequent GRASS sessions, the  pre-
       viously	saved mapset search path will be used (and will continue to be
       used until it is modified by the user with _g_._m_a_p_s_e_t_s).

OOPPTTIIOONNSS
   FFllaaggss::
       --ll     List all available mapsets under the user's current location.

       --pp     Print the user's current mapset search path to standard  output.


   PPaarraammeetteerrss::
       mmaappsseett==_n_a_m_e[,_n_a_m_e,...]
	      Name(s)  of existing GRASS mapset(s) under the current location.

       aaddddmmaappsseett==_n_a_m_e[,_n_a_m_e,...]
	      Name(s) of existing mapset(s) to add to search list

       _g_._m_a_p_s_e_t_s sets the current _m_a_p_s_e_t _s_e_a_r_c_h _p_a_t_h to the _m_a_p_s_e_t_s  named  on
       the command line.  If gg..mmaappsseettss is typed but no _m_a_p_s_e_t names are speci-
       fied by the user on the command line, the program will print the user's
       current mapset search path, list available mapsets, and prompt the user
       for a new mapset search path listing.


       The _a_d_d_m_a_p_s_e_t parameter allows for extending an existing _m_a_p_s_e_t	_s_e_a_r_c_h
       _p_a_t_h.

NNOOTTEESS
       Users  can restrict others' access to their mapset files through use of
       the GRASS program _g_._a_c_c_e_s_s.  Mapsets to which access is restricted  can
       still  be  listed  in  another's mapset search path; however, access to
       these mapsets will remain restricted.

SSEEEE AALLSSOO
       _g_._a_c_c_e_s_s

       _g_._c_o_p_y

       _g_._g_i_s_e_n_v

       _g_._l_i_s_t

AAUUTTHHOORR
       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory


       Greg Koerper, ManTech Environmental Technology, Inc.

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_3_/_0_2_/_0_9 _1_2_:_0_7_:_2_3 _$



GRASS 5.0							  g.mapsets(1)
