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)

       Accessed: Tuesday Jun 27 11:12:37 2023

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

       © 2003-2023 GRASS Development Team, GRASS GIS 8.3.0 Reference Manual