1g.mapsets(1)                GRASS GIS User's Manual               g.mapsets(1)
2
3
4

NAME

6       g.mapsets  - Modifies/prints the user’s current mapset search path.
7       Affects  the  user’s access to data existing under the other mapsets in
8       the current location.
9

KEYWORDS

11       general, settings, search path
12

SYNOPSIS

14       g.mapsets
15       g.mapsets --help
16       g.mapsets  [-lps]  mapset=name[,name,...]  operation=string    [separa‐
17       tor=character]   [--help]  [--verbose]  [--quiet]  [--ui]
18
19   Flags:
20       -l
21           List all available mapsets in alphabetical order
22
23       -p
24           Print mapsets in current search path
25
26       -s
27           Launch mapset selection GUI dialog
28
29       --help
30           Print usage summary
31
32       --verbose
33           Verbose module output
34
35       --quiet
36           Quiet module output
37
38       --ui
39           Force launching GUI dialog
40
41   Parameters:
42       mapset=name[,name,...] [required]
43           Name of mapset (default: current search path)
44           Name(s) of existing mapset(s) to add/remove or set
45
46       operation=string [required]
47           Operation to be performed
48           Options: set, add, remove
49           Default: add
50
51       separator=character
52           Field separator for printing (-l and -p flags)
53           Special characters: pipe, comma, space, tab, newline
54           Default: space
55

DESCRIPTION

57       For  basic information about GRASS mapset, location and data base refer
58       to GRASS Quickstart.
59
60       A mapset holds a distinct set of data layers, each relevant to the same
61       (or a subset of the same) geographic region, and each drawn in the same
62       map coordinate system.  At the outset of every GRASS session, the  user
63       identifies  a  GRASS data base, location, and mapset that are to be the
64       user’s current data base, current location, and current mapset for  the
65       duration  of  the session; any maps created by the user during the ses‐
66       sion will be stored under the current mapset set at the session’s  out‐
67       set (see g.mapset [without an "s"] and g.gisenv for changing the mapset
68       with a session).
69
70       The user can add, modify, and delete data layers that exist under their
71       current mapset. Although the user can also access (i.e., use) data that
72       are stored under other mapsets in the same  GRASS  location  using  the
73       mapname@mapsetname  notation  or  mapset search path, the user can only
74       make permanent changes (create or modify data) located in  the  current
75       mapset.   The  user’s mapset search path lists the order in which other
76       mapsets in the same GRASS location can be searched and their  data  ac‐
77       cessed  by the user. The user can modify the listing and order in which
78       these mapsets are accessed by modifying the mapset  search  path;  this
79       can  be  done using the g.mapsets command. This program allows the user
80       to use other’s relevant map data without  altering  the  original  data
81       layer,  and  without  taking  up disk space with a copy of the original
82       map. The mapname@mapsetname notation may be used  irrespective  of  the
83       mapset  search  path, i.e., any map found in another mapset with suffi‐
84       cient g.access privileges may be called in such a manner.
85
86       g.mapsets shows the user available mapsets under the current GRASS  lo‐
87       cation, lists mapsets to which the user currently has access, and lists
88       the order in which accessible mapsets will be accessed  by  GRASS  pro‐
89       grams searching for data files.  The user is then given the opportunity
90       to add or delete mapset names from the search path, or modify the order
91       in which mapsets will be accessed.
92
93       When  the  user specifies the name of a data base element file (e.g., a
94       particular vector map, raster map, imagery group file, etc.) to a GRASS
95       program,  the  program  searches  for  the named file under each of the
96       mapsets listed in the user’s mapset search path  in  the  order  listed
97       there  until the program finds a file of the given name. Users can also
98       specify a file by its mapset, to make explicit the  mapset  from  which
99       the file is to be drawn; e.g., the command:
100       g.copy raster=soils@PERMANENT,my_soils
101       ensures  that  a  new  file  named my_soils is to be a copy of the file
102       soils from the mapset PERMANENT.
103
104       In each location there is the special mapset PERMANENT included in  the
105       mapset  search  path, as this mapset typically contains base maps rele‐
106       vant to many applications. Often, other mapsets which contain  sets  of
107       interpreted  maps will be likewise included in the user’s mapset search
108       path.  Suppose, for example, that the mapset Soil_Maps contains  inter‐
109       preted  soils  map  layers  to  which the user wants access. The mapset
110       Soil_Maps should then be included in the user’s search path variable.
111
112       The mapset search path is saved as part of the current mapset. When the
113       user  works  with  that mapset in subsequent GRASS sessions, the previ‐
114       ously saved mapset search path will be used (and will  continue  to  be
115       used until it is modified by the user with g.mapsets).
116

NOTES

118       By  default  g.mapsets  adds  to the current mapset search path mapsets
119       named by mapset option. Alternatively mapsets can  be  removed  (opera‐
120       tion=remove) from the search path or defined by operation=set.
121
122       Users  can restrict others’ access to their mapset files through use of
123       g.access. Mapsets to which access is restricted can still be listed  in
124       another’s mapset search path; however, access to these mapsets will re‐
125       main restricted.
126

EXAMPLES

128   Selecting mapsets with the graphical mapset manager
129       Using the -s flag, a convenient graphical mapset manager can be  opened
130       to  select and deselect other mapsets (the actual mapset and the PERMA‐
131       NENT mapset are always selected):
132       g.mapsets -s
133
134   Print available mapsets
135       All available mapsets in the current location can be printed out by
136       g.mapsets -l
137       Available mapsets:
138       PERMANENT user1 user2
139
140   Add new mapset
141       Add mapset ’user2’ to the current mapset search path
142       g.mapsets mapset=user2 operation=add
143       The current mapset search path is changed accordingly
144       g.mapsets -p
145       Accessible mapsets:
146       user1 user2
147
148   Overwrite current search path
149       Overwrite current search path
150       g.mapsets mapset=user1,PERMANENT operation=set
151
152   Using shortcuts for search path
153       The current mapset can be defined by a shortcut "." (dot)
154       g.mapsets mapset=.,PERMANENT operation=set
155       Note: The current mapset will be always included in the search path  on
156       the  first position even if you change its position or omit the current
157       mapset from the mapset option.
158       g.mapsets -p
159       Accessible mapsets:
160       user1 PERMANENT
161

SEE ALSO

163        g.access, g.copy, g.gisenv, g.list, g.mapset
164

AUTHORS

166       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
167       Greg Koerper, ManTech Environmental Technology, Inc.
168       Updated to GRASS 7 by  Martin  Landa,  Czech  Technical  University  in
169       Prague, Czech Republic
170

SOURCE CODE

172       Available at: g.mapsets source code (history)
173
174       Accessed: Mon Jun 20 16:45:51 2022
175
176       Main  index | General index | Topics index | Keywords index | Graphical
177       index | Full index
178
179       © 2003-2022 GRASS Development Team, GRASS GIS 8.2.0 Reference Manual
180
181
182
183GRASS 8.2.0                                                       g.mapsets(1)
Impressum