wxPython GRASS Graphical User Interface ======================================= 0 - REQUIREMENTS GRASS GIS >= 6.3 Python >= 2.4 wxPython >= 2.8.1.1 Get wxPython 2.8.x packages from: * Source: http://www.wxpython.org/download.php * Debian GNU/Linux: http://wiki.wxpython.org/InstallingOnUbuntuOrDebian [ deb http://apt.wxwidgets.org/ etch-wx main ] http://www.bitpim.org/developer.html -> "Install wxPython" * Fedora: http://www.wxpython.org/download.php http://mpa.itc.it/markus/wxpython_rpms/fedora/ * Mandriva 2007.0: http://mpa.itc.it/markus/wxpython_rpms/mandriva2007.0/ * Mandriva 2007.1 (spring): available from main/backports (see http://club.mandriva.com/xwiki/bin/view/Downloads/MirrorFinder2 ) Also http://www.wxpython.org/download.php * MS-Windows: http://www.wxpython.org/download.php * OS X: http://www.wxpython.org/download.php * SuSe: * Ubuntu: deb http://wxpython.wxcommunity.com/apt/ubuntu/dapper / deb http://wxpython.wxcommunity.com/apt/ubuntu/feisty / Get Python from: * Python.org for Source, MS-Windows, OS X: http://www.python.org/download/ * ActiveStates for AIX, HP-UX, Linux (x86), Linux 64-bit (x86_64 AMD64), Mac OS X, Solaris (SPARC), Windows: http://www.activestate.com/store/download.aspx?prdGUID=b08b04e0-6872-4d9d-a722-7a0c2dea2758 E.g. On Debian GNU/Linux install these packages: apt-get install libwxbase2.8-0 libwxbase2.8-dbg libwxbase2.8-dev \ libwxgtk2.8-0 libwxgtk2.8-dbg libwxgtk2.8-dev \ python-wxgtk2.8 wx2.8-doc wx2.8-examples \ wx2.8-headers wx2.8-i18n 1 - INSTALLATION Go to: $ cd gui/wxpython and run $ make 2 - STARTUP WITH GRASS INITIALIZATION If you want to run wxPython GUI automatically when you start GRASS, edit your .grassrc6 file to replace GRASS_GUI: tcktk (or whatever you have here) with GRASS_GUI: wxpython or easier start new GRASS session with -wxpython switch. $ grass -wxpython 3 - STARTUP FROM GRASS TERMINAL Simply type $ g.gui wxpython from the GRASS terminal. You can also specify workspace file to load on startup. $ g.gui gui=wxpython workspace=myworkspace.grc 4 - CLI Display scripts Note: This section is out-dated. This is going to be replacement for command line tools like d.rast and d.vect. Now add directory "scripts" in gui directory to your $PATH. These little programs should later go to GRASS Scripts directory or became Python scripts or C programs. Now they are only small BASH wrappers which can be easily and fast customized. $~ export PATH=scripts/:$PATH Start GRASS: $~ grass63 ~/grassdata/spearfish60/user1 Use command p.mon (shell script in gui/scripts directory) to start map display: GRASS> p.mon anything After a while, new window should appear. If this is your case, add some raster layer to the map display: GRASS> p.rast aspect What about a bit transparency? GRASS> p.rast elevation.dem opacity=0.5 And try the vector layer too GRASS> p.vect roads NOTE: only map name is currently supported. No other option will influence the map layout Alternatively you can use more universal p.cmd: GRASS> p.cmd "d.rast map=elevation.dem@PERMANENT catlist=1300-1400 -i" 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. 5 - DEBUGGING To enable GUI debugging messages on given level set GRASS_DEBUG_WX environment variables, e.g. $ export GRASS_WX_DEBUG=3 6 - ICON THEMES Currently two icon themes are available: * original GRASS (based on TCL/TK GUI prototype) * Silk-based User can change icon theme in Preferences dialog ('Config->Preferences'). 7 - DIGITIZATION TOOL To enable digitization tool you need to compile 'vdigit' component. Note that you must configure GRASS with C++ (--with-cxx), Python (--with-python) and wxWidgets (--with-wxwidgets) support. First, create a symlink to _gdi_.so shared library $ ln -s `locate _gdi_.so` $GISBASE/lib/libgdi.so e.g. $ ln -s /usr/lib/python2.4/site-packages/wx-2.8-gtk2-unicode/wx/_gdi_.so $GISBASE/lib/libgdi.so Then you can compile the driver $ cd $GISBASE/etc/wxpython/vdigit $ make