NAME

       g.mapset  - Changes/reports current mapset.
       Optionally create new mapset or list available mapsets in given location.

KEYWORDS

       general, settings

SYNOPSIS

       g.mapset
       g.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 -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)

       Main index | General index | Topics index | Keywords index | Graphical index | Full index

       © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual