1g.mapsets(1)                  Grass 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
77       accessed  by  the  user.  The  user can modify the listing and order in
78       which these mapsets are accessed by modifying the mapset  search  path;
79       this  can  be done using the g.mapsets command. This program allows the
80       user to use other’s relevant map data  without  altering  the  original
81       data  layer, and without taking up disk space with a copy of the origi‐
82       nal map. The mapname@mapsetname notation may be  used  irrespective  of
83       the mapset search path, i.e., any map found in another mapset with suf‐
84       ficient g.access privileges may be called in such a manner.
85
86       g.mapsets shows the user available  mapsets  under  the  current  GRASS
87       location,  lists  mapsets  to  which the user currently has access, and
88       lists the order in which accessible mapsets will be accessed  by  GRASS
89       programs searching for data files.  The user is then given the opportu‐
90       nity to add or delete mapset names from the search path, or modify  the
91       order 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
125       remain 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

AUTHOR

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
171       Last changed: $Date: 2016-01-28 12:21:34 +0100 (Thu, 28 Jan 2016) $
172

SOURCE CODE

174       Available at: g.mapsets source code (history)
175
176       Main  index | General index | Topics index | Keywords index | Graphical
177       index | Full index
178
179       © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
180
181
182
183GRASS 7.6.0                                                       g.mapsets(1)
Impressum