1g.mapsets(1) Grass User's Manual g.mapsets(1)
2
6 g.mapsets - Modifies the user's current mapset search path, affecting
7 the user's access to data existing under the other GRASS mapsets in the
8 current location.
9
11 general
12
14 g.mapsets
15 g.mapsets help
16 g.mapsets [-lp] [mapset=string[,string,...]]
17 [addmapset=string[,string,...]] [--verbose] [--quiet]
18 Flags:
20 -l
21 List all available mapsets
22 -p
24 Print current mapset search path
25 --verbose
27 Verbose module output
28 --quiet
30 Quiet module output
31 Parameters:
33 mapset=string[,string,...]
34 Name(s) of existing mapset(s)
35 addmapset=string[,string,...]
37 Name(s) of existing mapset(s) to add to search list
38
40 For basic information about Grass mapset, location and data base refer
41 to GRASS Quickstart.
42 A mapset holds a distinct set of data layers, each relevant to the same
44 (or a subset of the same) geographic region, and each drawn in the same
45 map coordinate system. At the outset of every GRASS session, the user
46 identifies a GRASS data base, location, and mapset that are to be the
47 user's current data base, current location, and current mapset for the
48 duration of the session; any maps created by the user during the ses‐
49 sion will be stored under the current mapset set at the session's out‐
50 set. (see g.mapset [without an "s"] and g.gisenv for changing the
51 mapset with a session)
52 The user can add, modify, and delete data layers that exist under his
54 current mapset. Although the user can also access (i.e., use) data
55 that are stored under other mapsets in the same GRASS location using
56 the mapname@mapsetname notation or mapset search path, the user can
57 only make permanent changes (create or modify data) located in the cur‐
58 rent mapset. The user's mapset search path lists the order in which
59 other mapsets in the same GRASS location can be searched and their data
60 accessed by the user. The user can modify the listing and order in
61 which these mapsets are accessed by modifying the mapset search path;
62 this can be done using the g.mapsets command. This program allows the
63 user to use other's relevant map data without altering the original
64 data layer, and without taking up disk space with a copy of the origi‐
65 nal map. The mapname@mapsetname notation may be used irrespective of
66 the mapset search path, i.e., any map found in another mapset with suf‐
67 ficient g.access privileges may be called in such a manner.
68 g.mapsets shows the user available mapsets under the current GRASS
70 location, lists mapsets to which the user currently has access, and
71 lists the order in which accessible mapsets will be accessed by GRASS
72 programs searching for data files. The user is then given the opportu‐
73 nity to add or delete mapset names from his search path, or modify the
74 order in which mapsets will be accessed.
75 When the user specifies the name of a data base element file (e.g., a
77 particular vector map, raster map, imagery group file, etc.) to a
78 GRASS program, the program searches for the named file under each of
79 the mapsets listed in the user's mapset search path in the order listed
80 there until the program finds a file of the given name. (Users can
81 also specify a file by its mapset, to make explicit the mapset from
82 which the file is to be drawn; e.g., the command:
83 g.copy rast='soils.file@PERMANENT',my.soils
84 ensures that a new file named my.soils is to be a copy of the file
85 soils.file from the mapset PERMANENT.)
86 It is common for a user to have the special mapset PERMANENT included
88 in his mapset search path, as this mapset typically contains finished
89 base maps relevant to many applications. Often, other mapsets which
90 contain sets of interpreted map layers will be likewise included in the
91 user's mapset search path. Suppose, for example, that the mapset
92 Soil_Maps contains interpreted soils map layers to which the user wants
93 access. The mapset Soil_Maps should then be included in the user's
94 search path variable.
95 The mapset search path is saved as part of the current mapset. When
97 the user works with that mapset in subsequent GRASS sessions, the pre‐
98 viously saved mapset search path will be used (and will continue to be
99 used until it is modified by the user with g.mapsets).
100
102 g.mapsets sets the current mapset search path to the mapsets named on
103 the command line. If g.mapsets is typed but no mapset names are speci‐
104 fied by the user on the command line, the program will print the user's
105 current mapset search path, list available mapsets, and prompt the user
106 for a new mapset search path listing.
107 The addmapset parameter allows for extending an existing mapset search
109 path.
110 Users can restrict others' access to their mapset files through use of
112 the GRASS program g.access. Mapsets to which access is restricted can
113 still be listed in another's mapset search path; however, access to
114 these mapsets will remain restricted.
115
117 g.access
118 g.copy
119 g.gisenv
120 g.list
121 g.mapset
122
124 Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
125 Greg Koerper, ManTech Environmental Technology, Inc.
127 Last changed: $Date: 2007-05-30 10:45:46 +0200 (Wed, 30 May 2007) $
129 Full index
131 © 2003-2008 GRASS Development Team
133GRASS 6.3.0 g.mapsets(1)