1g.gui(1) Grass User's Manual g.gui(1)
2
3
4
6 g.gui - Launches a GRASS graphical user interface (GUI) session.
7 Optionally updates default user interface settings.
8
10 general, GUI, user interface
11
13 g.gui
14 g.gui --help
15 g.gui [-fdn] [ui=string] [workspace=name.gxw] [--help] [--ver‐
16 bose] [--quiet] [--ui]
17
18 Flags:
19 -f
20 Start GUI in the foreground
21 By default the GUI starts in the background and control is immedi‐
22 ately returned to the caller. When GUI runs in foregreound, it
23 blocks the command line
24
25 -d
26 Update default user interface settings
27
28 -n
29 Do not launch GUI after updating the default user interface set‐
30 tings
31
32 --help
33 Print usage summary
34
35 --verbose
36 Verbose module output
37
38 --quiet
39 Quiet module output
40
41 --ui
42 Force launching GUI dialog
43
44 Parameters:
45 ui=string
46 User interface
47 Options: wxpython, text, gtext
48 Default: wxpython
49 wxpython: wxPython based GUI (wxGUI)
50 text: command line interface only
51 gtext: command line interface with GUI startup screen
52
53 workspace=name.gxw
54 Name of workspace file to load on start-up
55 This is valid only for wxGUI (wxpython)
56
58 The g.gui module allows user to start the Graphical User Interface
59 (GUI) from the command line prompt or to change the default User Inter‐
60 face (UI) settings.
61
62 GRASS GIS 7 comes with both a wxPython-based GUI aka wxGUI
63 (ui=wxpython) and command line text-based UI (ui=text).
64
66 If the -d update flag is given or the GRASS_GUI environmental variable
67 is unset, then the GRASS internal variable GUI is permanently changed
68 and the selected ui will be used as the default UI from then on.
69
70 All GRASS internal variables (see g.gisenv) are stored in the user’s
71 home directory in a hidden file called $HOME/.grass7/rc on Unix-based
72 operating systems and %APPDATA%\GRASS7\rc on MS Windows. Note that
73 these GRASS internal variables are not the shell environment variables
74 and the rc file is not a classic UNIX run command file, it just con‐
75 tains persistent GRASS variables.
76
77 The old gis.m and d.m Tcl/Tk-based GUIs known from GRASS GIS 6 have
78 been dropped in GRASS GIS 7.
79
81 Set default user interface setting to command line, text-based UI:
82 g.gui -d ui=text
83
84 Set default user interface setting to the graphical user interface
85 (GUI) and launch the GUI:
86 g.gui -d ui=wxpython
87
88 Set default user interface setting to the graphical user interface
89 (GUI) but do not launch the GUI:
90 g.gui -dn ui=wxpython
91
93 wxGUI, g.gisenv, GRASS variables
94
95 wxGUI wiki page
96
98 Martin Landa, FBK-irst, Trento, Italy
99 Hamish Bowman, Otago University, Dunedin, New Zealand (fine tuning)
100
101 Last changed: $Date: 2014-04-21 13:55:01 +0200 (Mon, 21 Apr 2014) $
102
104 Available at: g.gui source code (history)
105
106 Main index | General index | Topics index | Keywords index | Graphical
107 index | Full index
108
109 © 2003-2019 GRASS Development Team, GRASS GIS 7.4.4 Reference Manual
110
111
112
113GRASS 7.4.4 g.gui(1)