g.mapset
Changes/reports current mapset.
Optionally create new mapset or list available mapsets in given project (location).
g.mapset [-clp] mapset=name [project=name] [dbase=path] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]
Example:
g.mapset mapset=name
grass.script.run_command("g.mapset", mapset, project=None, dbase=None, flags=None, overwrite=False, verbose=False, quiet=False, superquiet=False)
Example:
gs.run_command("g.mapset", mapset="name")
Parameters
mapset=name [required]
Name of mapset (default: current search path)
Name of mapset where to switch
project=name
Project (location) name
Project name (not path to project)
dbase=path
GRASS GIS database directory
Default: path to the current GRASS GIS database
-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
--qq
Very quiet module output
--ui
Force launching GUI dialog
mapset : str, required
Name of mapset (default: current search path)
Name of mapset where to switch
Used as: output, mapset, name
project : str, optional
Project (location) name
Project name (not path to project)
Used as: input, location, name
dbase : str, optional
GRASS GIS database directory
Default: path to the current GRASS GIS database
Used as: input, dbase, path
flags : str, optional
Allowed values: c, l, p
c
Create mapset if it doesn't exist
l
List available mapsets and exit
p
Print current mapset and exit
overwrite: bool, optional
Allow output files to overwrite existing files
Default: False
verbose: bool, optional
Verbose module output
Default: False
quiet: bool, optional
Quiet module output
Default: False
superquiet: bool, optional
Very quiet module output
Default: False
DESCRIPTION
g.mapset changes the current working mapset, project (formerly known as location), or GISDBASE (directory with one or more projects).
With g.mapset, the shell history (i.e. .bash_history
file of the
initial project 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 project=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 project=nc_spm_08_grass7
SEE ALSO
AUTHOR
Radim Blazek
SOURCE CODE
Available at: g.mapset source code
(history)
Latest change: Friday Feb 07 19:16:09 2025 in commit a82a39f