README 3.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128
  1. GRASS GIS - wxPython Graphical User Interface (wxGUI)
  2. =====================================================
  3. $Date$
  4. 1 - REQUIREMENTS
  5. GRASS GIS >= 6.4
  6. Python >= 2.4 (Python 3 not supported)
  7. Python ElementTree (only for Python 2.4)
  8. wxPython >= 2.8.1.1
  9. NumPy >= 1.0.4
  10. Get wxPython 2.8.x packages from:
  11. * Source: http://www.wxpython.org/download.php
  12. * Debian GNU/Linux: http://wiki.wxpython.org/InstallingOnUbuntuOrDebian
  13. * Fedora: http://www.wxpython.org/download.php
  14. * Mandriva: included in main distribution
  15. * OpenSuSe: http://download.opensuse.org/repositories/Application:/Geo/
  16. * Ubuntu: deb http://wxpython.wxcommunity.com/apt/ubuntu/dapper /
  17. deb http://wxpython.wxcommunity.com/apt/ubuntu/feisty /
  18. * MacOSX: http://www.wxpython.org/download.php
  19. * MS-Windows: http://www.wxpython.org/download.php
  20. Get Python from:
  21. * Python.org for Source, MS-Windows, OS X: http://www.python.org/download/
  22. * ActiveStates for AIX, HP-UX, Linux (x86), Linux 64-bit (x86_64 AMD64), Mac OS X,
  23. Solaris (SPARC), Windows:
  24. http://www.activestate.com/store/download.aspx?prdGUID=b08b04e0-6872-4d9d-a722-7a0c2dea2758
  25. E.g. On Debian GNU/Linux install these packages:
  26. apt-get install libwxbase2.8-0 libwxbase2.8-dbg libwxbase2.8-dev \
  27. libwxgtk2.8-0 libwxgtk2.8-dbg libwxgtk2.8-dev \
  28. python-wxgtk2.8 wx2.8-doc wx2.8-examples \
  29. wx2.8-headers wx2.8-i18n python-numpy
  30. On Mandriva 2009 GNU/Linux, install these packages:
  31. urpmi lib64wxgtk2.8 lib64wxgtk2.8-devel lib64wxgtkgl2.8 wxgtk2.8 \
  32. lib64wxPythonGTK2.8 lib64wxPythonGTK2.8-devel wxPythonGTK wxPythonGTK-wxversion
  33. MS-WINDOWS ONLY REQUIREMENTS
  34. Python Extensions for MS-Windows >= Build 210
  35. Get Python Extensions for MS-Windows from:
  36. http://sourceforge.net/project/platformdownload.php?group_id=78018
  37. Get NumPy from:
  38. http://sourceforge.net/project/showfiles.php?group_id=1369&package_id=175103
  39. 2 - STARTUP WITH GRASS INITIALIZATION
  40. If you want to launch wxPython GUI automatically, start GRASS with
  41. `-gui` parameter
  42. $ grass70 -gui
  43. 3 - STARTUP FROM GRASS TERMINAL
  44. Simply run
  45. $ g.gui wxpython
  46. from the GRASS terminal.
  47. You can also specify workspace file to load on startup.
  48. $ g.gui gui=wxpython workspace=myworkspace.gxw
  49. 4 - DEBUGGING
  50. To enable GUI debug messages on given level set WX_DEBUG environment
  51. variable, e.g.
  52. $ g.gisenv set="WX_DEBUG=3"
  53. 5 - CLI Display scripts
  54. Note: This section is out-dated!
  55. This is going to be replacement for command line tools like d.rast and
  56. d.vect.
  57. Now add directory "scripts" in gui directory to your $PATH. These
  58. little programs should later go to GRASS Scripts directory or became
  59. Python scripts or C programs. Now they are only small BASH wrappers
  60. which can be easily and fast customized.
  61. $~ export PATH=scripts/:$PATH
  62. Start GRASS:
  63. $~ grass70 ~/grassdata/spearfish60/user1
  64. Use command p.mon (shell script in gui/scripts directory) to start map
  65. display:
  66. GRASS> p.mon anything
  67. After a while, new window should appear. If this is your case, add some
  68. raster layer to the map display:
  69. GRASS> p.rast aspect
  70. What about a bit transparency?
  71. GRASS> p.rast elevation.dem opacity=0.5
  72. And try the vector layer too
  73. GRASS> p.vect roads
  74. NOTE: only map name is currently supported. No other option will influence
  75. the map layout
  76. Alternatively you can use more universal p.cmd:
  77. GRASS> p.cmd "d.rast map=elevation.dem@PERMANENT catlist=1300-1400 -i"
  78. You should be able to zoom && pan through the map, once the layers are
  79. displayed. You should be also able to store the display content as well as
  80. clear the display and start from scratch.