1g.mapsets(1) GRASS GIS User's Manual g.mapsets(1)
2
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
11 general, settings, search path
12
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 Flags:
20 -l
21 List all available mapsets in alphabetical order
22 -p
24 Print mapsets in current search path
25 -s
27 Launch mapset selection GUI dialog
28 --help
30 Print usage summary
31 --verbose
33 Verbose module output
34 --quiet
36 Quiet module output
37 --ui
39 Force launching GUI dialog
40 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 operation=string [required]
47 Operation to be performed
48 Options: set, add, remove
49 Default: add
50 separator=character
52 Field separator for printing (-l and -p flags)
53 Special characters: pipe, comma, space, tab, newline
54 Default: space
55
57 For basic information about GRASS mapset, location and data base refer
58 to GRASS Quickstart.
59 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 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 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 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 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 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
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 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
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 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 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 Overwrite current search path
149 Overwrite current search path
150 g.mapsets mapset=user1,PERMANENT operation=set
151 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
163 g.access, g.copy, g.gisenv, g.list, g.mapset
164
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
172 Available at: g.mapsets source code (history)
173 Accessed: Saturday Jan 21 20:38:12 2023
175 Main index | General index | Topics index | Keywords index | Graphical
177 index | Full index
178 © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
180GRASS 8.2.1 g.mapsets(1)