README 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980
  1. GRASS GIS - wxPython Graphical User Interface (wxGUI)
  2. =====================================================
  3. $Date$
  4. 1 - REQUIREMENTS
  5. GRASS GIS >= 6.4
  6. Python >= 2.4
  7. Python ElementTree (only for Python 2.4)
  8. wxPython >= 2.8.10.1
  9. NumPy >= 1.0.4
  10. PIL >= 1.1.7
  11. 2 - STARTUP WITH GRASS INITIALIZATION
  12. If you want to launch wxPython GUI automatically, start GRASS with
  13. `--gui` parameter
  14. $ grass --gui
  15. 3 - STARTUP FROM GRASS TERMINAL
  16. Simply run
  17. $ g.gui wxpython
  18. from the GRASS terminal.
  19. You can also specify workspace file to load on startup.
  20. $ g.gui gui=wxpython workspace=myworkspace.gxw
  21. 4 - DEBUGGING
  22. To enable GUI debug messages on given level set WX_DEBUG environment
  23. variable, e.g.
  24. $ g.gisenv set="WX_DEBUG=3"
  25. 5 - CLI BASED DISPLAY USAGE
  26. Use command d.mon (shell script in gui/scripts directory) to start map
  27. display:
  28. GRASS> d.mon wx[0-6]
  29. After a while, new window should appear. If this is your case, add some
  30. raster layer to the map display:
  31. GRASS> d.rast aspect
  32. And try the vector layer too
  33. GRASS> d.vect roads
  34. You should be able to zoom && pan through the map, once the layers are
  35. displayed. You should be also able to store the display content as well as
  36. clear the display and start from scratch.
  37. 6 TRANSLATION HANDLING
  38. Notes:
  39. - Help part of menu entries is coming from the module descriptions
  40. - The menu is maintained manually in xml/menudata.xml
  41. Update of module description strings in xml/menudata.xml:
  42. - in a GRASS session, run tools/update_menudata.py
  43. From this (updated) xml/menudata.xml, the gettext strings are generated
  44. via Makefile and stored into the file "menustrings.py".
  45. When generating the po files in locale/po/ but locale/Makefile, all
  46. .py files are parsed and the strings are stored in locale/po/grasswxpy_XX.po