NAME

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

KEYWORDS

       general, settings

SYNOPSIS

       g.mapset
       g.mapset --help
       g.mapset  [-clp]  mapset=name   [project=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

       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

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

        g.gisenv, g.mapsets

AUTHOR

       Radim Blazek

SOURCE CODE

       Available at: g.mapset source code (history)

       Accessed: Thursday Aug 01 11:29:44 2024

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

       © 2003-2024 GRASS Development Team, GRASS GIS 8.4.0 Reference Manual