table of contents
other versions
- buster 7.6.0-1
- testing 7.8.5-1
- unstable 7.8.5-1
- experimental 7.8.6~rc2-1~exp1
g.mapset(1grass) | Grass User's Manual | g.mapset(1grass) |
NAME¶
g.mapset - Changes/reports current mapset.Optionally create new mapset or list available mapsets in given location.
KEYWORDS¶
general, settingsSYNOPSIS¶
g.mapsetg.mapset --help
g.mapset [-clp] mapset=name [location=name] [dbase=path] [--overwrite] [--help] [--verbose] [--quiet] [--ui]
Flags:¶
- -c
-
Create mapset if it doesn’t exist - -l
-
List available mapsets and exit - -p
-
Print current mapset and exit - --overwrite
-
Allow output files to overwrite existing files - --help
-
Print usage summary - --verbose
-
Verbose module output - --quiet
-
Quiet module output - --ui
-
Force launching GUI dialog
Parameters:¶
- mapset=name [required]
-
Name of mapset (default: current search path)
Name of mapset where to switch - location=name
-
Location name
Location name (not location path) - dbase=path
-
GRASS GIS database directory
Default: path to the current GRASS GIS database
DESCRIPTION¶
g.mapset changes the current working MAPSET, LOCATION, or GISDBASE. This is a fairly radical maneuver to run mid-session, take care when running the GUI at the same time.With g.mapset, the shell history (i.e. .bash_history file of the initial location will be used to record the command history.
NOTES¶
By default, the shell continues to use the history for the old mapset. To change this behaviour the history can be switched to record in the new mapset’s history file as follows:# bash example history -w history -r /"$GISDBASE/$LOCATION/$MAPSET"/.bash_history HISTFILE=/"$GISDBASE/$LOCATION/$MAPSET"/.bash_history
EXAMPLES¶
Print the name of the current mapset¶
To print the name of the current mapset, use the -p command as shown below:g.mapset -p
List available mapsets¶
To list available mapsets, use the -l command as shown below:g.mapset -lThis should list all the mapsets, such as: "landsat new PERMANENT user1."
Change the current mapset¶
To change the current mapset to "user1" use the following command:g.mapset mapset=user1 location=nc_spm_08_grass7You should receive the following message: "Mapset switched. Your shell continues to use the history for the old mapset."
Create a new mapset¶
To create a new mapset, use the -c tag as shown below:g.mapset -c mapset=new location=nc_spm_08_grass7
SEE ALSO¶
g.gisenv, g.mapsetsAUTHOR¶
Radim BlazekLast changed: $Date: 2017-12-30 12:13:03 +0100 (Sat, 30 Dec 2017) $
SOURCE CODE¶
Available at: g.mapset source code (history)Main index | General index | Topics index | Keywords index | Graphical index | Full index
© 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
GRASS 7.6.0 |