Zeobuilder is developed and tested on modern Linux environments. The installation instructions below are given for a Linux system only. If you want to use Zeobuilder on other operating systems such as Windows or OSX, you should have a minimal computer geek status to get it working. We are always interested in hearing from your installation adventures.
MolMod is a Python library used by most Python programs developed at the CMM. It must be installed before Zeobuilder can be used or installed. Installation and download instructions can be found in the molmod documentation. The instructions below only work if the MolMod package is installed.
Some software packages should be installed before Zeobuilder can be installed or used. It is recommended to use the software package management of your Linux distribution to install these dependencies.
The following software must be installed:
Most Linux distributions can install this software with just a single terminal command.
sudo apt-get install python-gtk2 python-opengl python-numpy python-gtkglext1 python-matplotlib
sudo yum install pygtk2 pygtk2-libglade PyOpenGL numpy pygtkglext python-matplotlib
The following series of commands will download the latest version of Zeobuilder, and will then install it into your home directory.
cd ~/build/ git clone git://github.com/molmod/zeobuilder.git (cd zeobuilder; ./setup.py install --home=~)
You are now ready to start using Zeobuilder!
In case you want to upgrade Zeobuilder to the latests development version after a previous install, then execute the following commands (in the same directory that was originally used to install Zeobuilder):
cd ~/build/ (cd molmod; ./cleanfiles.sh; git pull; rm -r ~/lib*/python/molmod*; ./setup.py install --home=~) (cd zeobuilder; ./cleanfiles.sh; git pull; rm -r ~/lib*/python/zeobuilder*; ./setup.py install --home=~)
For the development and testing one needs to install additional packages
Most Linux distributions can install this software with just a single terminal command:
sudo apt-get install python-nose python-sphinx
su - apt-get install python-nose python-sphinx exit
sudo yum install python-nose sphinx
sudo zypper install python-nose sphinx
Once these dependencies are installed, execute the following commands to run the tests:
cd ~/build/zeobuilder nosetests -v
If some tests fail, post the output of the tests on the Zeobuilder mailing list.