Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
g.mapset(1)		    GRASS GIS User's Manual		   g.mapset(1)

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=nameA [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)

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

       A(C) 2003-2020 GRASS Development	Team, GRASS GIS	7.8.4 Reference	Manual

GRASS 7.8.4							   g.mapset(1)

NAME | KEYWORDS | SYNOPSIS | DESCRIPTION | NOTES | EXAMPLES | SEE ALSO | AUTHOR | SOURCE CODE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=g.mapset&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help