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,...]]

DDEESSCCRRIIPPTTIIOONN
       A  _m_a_p_s_e_t  holds a distinct set of data layers, each rele-
       vant 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 session will be  stored  under  the
       _c_u_r_r_e_n_t _m_a_p_s_e_t ($MAPSET) set at the session'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 tak-
       ing 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  cur-
       rent  GRASS location, lists mapsets to which the user cur-
       rently 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 opportunity 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  PPEERRMMAA--
       NNEENNTT  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 subse-
       quent GRASS sessions, the previously 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  cur-
	      rent location.

       _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 specified by the user on the com-
       mand 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.

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_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_3 _$



GRASS 5.0					     g.mapsets(1)
