GRASS GIS - wxPython Graphical User Interface (wxGUI)

$Date$

1 - REQUIREMENTS

GRASS GIS >= 6.4 Python >= 2.4 Python ElementTree (only for Python 2.4) wxPython >= 2.8.10.1 NumPy >= 1.0.4 PIL >= 1.1.7

2 - STARTUP WITH GRASS INITIALIZATION

If you want to launch wxPython GUI automatically, start GRASS with --gui parameter

$ grass --gui

3 - STARTUP FROM GRASS TERMINAL

Simply run

$ g.gui wxpython

from the GRASS terminal.

You can also specify workspace file to load on startup.

$ g.gui gui=wxpython workspace=myworkspace.gxw

4 - DEBUGGING

To enable GUI debug messages on given level set WX_DEBUG environment variable, e.g.

$ g.gisenv set="WX_DEBUG=3"

5 - CLI BASED DISPLAY USAGE

Use command d.mon (shell script in gui/scripts directory) to start map display:

GRASS> d.mon wx[0-6]

After a while, new window should appear. If this is your case, add some raster layer to the map display:

GRASS> d.rast aspect

And try the vector layer too

GRASS> d.vect roads

You should be able to zoom && pan through the map, once the layers are displayed. You should be also able to store the display content as well as clear the display and start from scratch.

6 TRANSLATION HANDLING

Notes:

• Help part of menu entries is coming from the module descriptions
• The menu is maintained manually in xml/menudata.xml

Update of module description strings in xml/menudata.xml:

• in a GRASS session, run tools/update_menudata.py

From this (updated) xml/menudata.xml, the gettext strings are generated via Makefile and stored into the file "menustrings.py".

When generating the po files in locale/po/ but locale/Makefile, all .py files are parsed and the strings are stored in locale/po/grasswxpy_XX.po