g.mapset(1grass) GRASS GIS User's Manual g.mapset(1grass)
NAME
g.mapset - Changes/reports current mapset.
Optionally create new mapset or list available mapsets in given loca-
tion.
KEYWORDS
general, settings
SYNOPSIS
g.mapset
g.mapset --help
g.mapset [-clp] mapset=name [location=name] [dbase=path] [--over-
write] [--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 ini-
tial 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 -l
This 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_grass7
You 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.mapsets
AUTHOR
Radim Blazek
SOURCE CODE
Available at: g.mapset source code (history)
Accessed: unknown
Main index | General index | Topics index | Keywords index | Graphical
index | Full index
© 2003-2022 GRASS Development Team, GRASS GIS 7.8.7 Reference Manual
GRASS 7.8.7 g.mapset(1grass)
Generated by dwww version 1.14 on Fri Jan 24 09:43:38 CET 2025.