| 1 | --------------------------------------------------- |
|---|
| 2 | |
|---|
| 3 | SAGE UI README |
|---|
| 4 | (version 3.0a) |
|---|
| 5 | |
|---|
| 6 | --------------------------------------------------- |
|---|
| 7 | (last updated on Feb, 2008) |
|---|
| 8 | |
|---|
| 9 | |
|---|
| 10 | |
|---|
| 11 | |
|---|
| 12 | (1) REQUIREMENTS (none for binary distributions): |
|---|
| 13 | ------------------------------------------------- |
|---|
| 14 | |
|---|
| 15 | - Python 2.4 (www.python.org) |
|---|
| 16 | - wxPython 2.6.2 (www.wxPython.org) |
|---|
| 17 | - either one of the following (numpy preferred): |
|---|
| 18 | - numpy (http://numpy.scipy.org) |
|---|
| 19 | - nummarray (it's being phased out though so SAGE UI has been made |
|---|
| 20 | compatible with the first two packages) |
|---|
| 21 | |
|---|
| 22 | |
|---|
| 23 | (2) HOW TO RUN: |
|---|
| 24 | --------------- |
|---|
| 25 | |
|---|
| 26 | - make sure that fsManager is already running on the machine you are trying to connect to |
|---|
| 27 | - run SAGE UI: |
|---|
| 28 | |
|---|
| 29 | FROM BINARY: |
|---|
| 30 | Windows - sageui [options] |
|---|
| 31 | Mac - ./sageui [options] |
|---|
| 32 | |
|---|
| 33 | FROM SOURCE: |
|---|
| 34 | Linux, Windows - python sageui.py [options] |
|---|
| 35 | Mac - pythonw sageui.py [options] |
|---|
| 36 | |
|---|
| 37 | - to see a list of options run the UI with "-h" (such as python sageui.py -h) |
|---|
| 38 | |
|---|
| 39 | |
|---|
| 40 | |
|---|
| 41 | (3) KNOWN BUGS: |
|---|
| 42 | ---------------- |
|---|
| 43 | |
|---|
| 44 | - under some versions of KDE the background color of the panel that shows the performance |
|---|
| 45 | data might look odd.The reason behind this is that the new versions of wxPython strictly |
|---|
| 46 | obey the current theme's colors and will not allow them to be changed by the application |
|---|
| 47 | itself. The issue seems to be related to the QT drawing used in KDE themes. Since GNOME |
|---|
| 48 | uses GTK (which is what linux version of wxPython uses for its drawing), it won't exhibit |
|---|
| 49 | the same problem and the colors will look normal. |
|---|
| 50 | |
|---|
| 51 | |
|---|
| 52 | |
|---|
| 53 | --------------------------------------------- |
|---|
| 54 | Feb, 2008 |
|---|
| 55 | Ratko Jagodic - rjagodic@gmail.com |
|---|
