Installation

Installing hyplot

Obtaining the code

The source code for hyplot can be downloaded as a tarball from this website, or you can obtain it using svn:

svn checkout svn://svn.code.sf.net/p/hyplot/code/trunk hyplot-code

Contributors that also want write access need to use

svn checkout --username=USERNAME svn+ssh://USERNAME@svn.code.sf.net/p/hyplot/code/trunk hyplot-code

(where USERNAME of course needs to be replaced by an actual username).

Compiling the code

Hyplot makes use of cmake to automatically detect dependencies and generate Makefiles. Before invoking cmake, make sure you have the following libraries installed:

• Python (version 2.6 or 2.7)
• Sip (python-sip-dev)
• PyQt4 (python-qt4, python-qt4-dev, pyqt4-dev-tools)
• GSL (libgsl-dev)
• Numeric Python (python-numpy)
• Scientific Python (python-scipy)
• Matplotlib (python-matplotlib)

If you also want to be able to generate code documentation, you will also need:

• Doxygen

Go to the folder in which you downloaded the source code and make a new folder in which to build the code (typically called build). From within this folder, issue the following command:

cmake -DCMAKE_BUILD_TYPE=Release -DU12=True ../hyplot-code

(where hyplot-code is the directory which contains the file CMakeLists.txt). Users with systems older than Ubuntu version 12.04 which use Python 2.6 instead of 2.7 can omit the -DU12=True directive.

Cmake will hopefully copy the necessary files into the build folder and generate a Makefile. You can then compile the code by typing

make

This will build hyplot. This process can take some time (~10 mins). If everything succeeds, the hyplot executable will be copied to build/rundir.

Ubuntu 14.04 users might experience a Python error while compiling resulting from a system file and a hyplot file having the same name (io.py). The workaround for this is to temporarily rename the file hyplot-code/hyplot/io.py and recompile. Now the color tables will be generated as they should and the compilation will succeed. Remember to restore hyplot-code/hyplot/io.py afterwards, because not doing this will result in errors while using hyplot!

Installation

To make the hyplot program available throughout the entire system, add the following line to ~/.bashrc:

export PATH=$PATH:/HYPLOT_FOLDER/build/rundir

(where HYPLOT_FOLDER is the absolute path to the folder where hyplot was compiled).