Martin Landa 38c2b95355 wxGUI major code reorganization (part 3) vor 13 Jahren
..
compat b671e428c5 parse docstrings by doxygen vor 16 Jahren
core 835020d28a wxGUI major code reorganization (part 2) vor 13 Jahren
dbm c730ae7e6f wxGUI major code reorganization vor 13 Jahren
docs 624f44f91e wxNviz: update man page vor 13 Jahren
gcp c730ae7e6f wxGUI major code reorganization vor 13 Jahren
gmodeler 835020d28a wxGUI major code reorganization (part 2) vor 13 Jahren
gui_core 835020d28a wxGUI major code reorganization (part 2) vor 13 Jahren
icons 38c2b95355 wxGUI major code reorganization (part 3) vor 13 Jahren
lmgr 835020d28a wxGUI major code reorganization (part 2) vor 13 Jahren
location_wizard c730ae7e6f wxGUI major code reorganization vor 13 Jahren
mapdisp 835020d28a wxGUI major code reorganization (part 2) vor 13 Jahren
modules 835020d28a wxGUI major code reorganization (part 2) vor 13 Jahren
nviz 835020d28a wxGUI major code reorganization (part 2) vor 13 Jahren
psmap 835020d28a wxGUI major code reorganization (part 2) vor 13 Jahren
scripts c730ae7e6f wxGUI major code reorganization vor 13 Jahren
tools 38c2b95355 wxGUI major code reorganization (part 3) vor 13 Jahren
vdigit c730ae7e6f wxGUI major code reorganization vor 13 Jahren
wxplot c730ae7e6f wxGUI major code reorganization vor 13 Jahren
xml f893c94851 wxGUI: Map Composer: add EPS image and north arrow vor 13 Jahren
Makefile c730ae7e6f wxGUI major code reorganization vor 13 Jahren
README 62115ae60c minor update of wxGUI/README vor 14 Jahren
create__init__.py c730ae7e6f wxGUI major code reorganization vor 13 Jahren
gis_set.py 835020d28a wxGUI major code reorganization (part 2) vor 13 Jahren
gis_set_error.py 38c2b95355 wxGUI major code reorganization (part 3) vor 13 Jahren
states.txt c730ae7e6f wxGUI major code reorganization vor 13 Jahren
wxgui.py 38c2b95355 wxGUI major code reorganization (part 3) vor 13 Jahren
wxpythonlib.dox 451d2fe561 wxGUI: various import-oriented fixes vor 13 Jahren

README

GRASS GIS - wxPython Graphical User Interface (wxGUI)
=====================================================

$Date$

1 - REQUIREMENTS

GRASS GIS >= 6.4
Python >= 2.4 (Python 3 not supported)
Python ElementTree (only for Python 2.4)
wxPython >= 2.8.1.1
NumPy >= 1.0.4

Get wxPython 2.8.x packages from:
* Source: http://www.wxpython.org/download.php
* Debian GNU/Linux: http://wiki.wxpython.org/InstallingOnUbuntuOrDebian
* Fedora: http://www.wxpython.org/download.php
* Mandriva: included in main distribution
* OpenSuSe: http://download.opensuse.org/repositories/Application:/Geo/
* Ubuntu: deb http://wxpython.wxcommunity.com/apt/ubuntu/dapper /
deb http://wxpython.wxcommunity.com/apt/ubuntu/feisty /

* MacOSX: http://www.wxpython.org/download.php
* MS-Windows: http://www.wxpython.org/download.php

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 python-numpy

On Mandriva 2009 GNU/Linux, install these packages:
urpmi lib64wxgtk2.8 lib64wxgtk2.8-devel lib64wxgtkgl2.8 wxgtk2.8 \
lib64wxPythonGTK2.8 lib64wxPythonGTK2.8-devel wxPythonGTK wxPythonGTK-wxversion


MS-WINDOWS ONLY REQUIREMENTS

Python Extensions for MS-Windows >= Build 210

Get Python Extensions for MS-Windows from:
http://sourceforge.net/project/platformdownload.php?group_id=78018
Get NumPy from:
http://sourceforge.net/project/showfiles.php?group_id=1369&package_id=175103


2 - STARTUP WITH GRASS INITIALIZATION

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

$ grass70 -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 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:

$~ grass70 ~/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.