Spire and the Python Tools are included in the SPIDER distribution. This Spire installation assumes that you already have installed SPIDER on your system.
Spire is written in Python and uses the Tk/Tkinter graphics library as well as some other Python packages. It comes with its own version of Python and all the required packages.
This installation will only use SPIDER's python to run the executable scripts in the /YOUR_SPIDER_DIRECTORY/tools/bin directory. It will not superceed any previously installed Python on your system.
Access the Spire directory in your SPIDER distribution and run the
Spire installation shell script: ./install.sh
(be sure it starts with dot-slash!):
cd YOUR_SPIDER_DIR/spire
./install.sh
If you have not already done so,the installer will first uncompress and unpack the Spire tar archive: spire.tar
When the installer finds all of the necessary system requirements,
it will ask for the correct command to run SPIDER on your system e.g.:
Is this the correct command to run spider?:
/usr/spider/bin/spider
Just follow its response instructions.
The installer may ask to add: YOUR_SPIDER_DIRECTORY/spire/bin to your 'path'. This directory contains executables for Spire and the python tools. If you do not want the script to edit your startup file you can say 'No'.
If you did not allow the installer script to alter your shell startup files you will
have to edit them yourself:
If you are using csh, add the: tools/bin directory to your path by adding the following line in your .cshrc file (substituting for the correct value for 'YOUR_SPIDER_DIRECTORY'):
setenv PATH /YOUR_SPIDER_DIRECTORY/tools/bin:$PATH
or if you are using bash add the: tools/bin directory to your path by adding the following lines in your .bashrc file (substituting for the correct value for 'YOUR_SPIDER_DIRECTORY'):
PATH=/YOUR_SPIDER_DIRECTORY/tools/bin:$PATH
export PATH
Run Spire and the Python tool programs without the .py extension, e.g., 'spire' not 'spire.py' and 'qview', not 'qview.py'. This will ensure that the proper Python executables and libraries are used.
The shell script: install.sh calls: setup.py
Then setup.py tries to find the command that to run SPIDER
on your system, and writes this command to: Spire/LocalVars.py
Spire/LocalVars.py will then contain a line like this:
spidercmd = '/usr/local/bin/spider'
The installation will create and access various sub-directories under: YOUR_SPIDER_DIRECTORY/spire including:
| Subdirectory | Contents |
|---|---|
| bin | python2.5, python2.7, spire, and various python tools |
| lib | Dependencies like tk/tcl, etc |
| config | Configuration files |
Additional packages used by Spire which are installed together with Spire:
| Python2.5 | www.python.org/download |
| Python2.7 | www.python.org/download |
| Tcl/Tk8.4 (or later) | www.tcl.tk/software/tcltk |
| BLT (a Tcl plotting package) | sourceforge.net/projects/blt |
| Python megawidgets (Pmw) | sourceforge.net/projects/pmw |
| Python Imaging Library (PIL) | www.pythonware.com/products/pil |
| Numpy (Python Numeric) | sourceforge.net/projects/numpy |
| Gnuplot.py | gnuplot-py.sourceforge.net |