Installation linux

From relax wiki
Revision as of 12:26, 25 July 2013 by Bugman (talk | contribs) (The GUI mode is now a separate section.)
Jump to navigation Jump to search

Installing the relax dependencies

The python-devel and scons packages are only required if the C modules need to be compiled for your system.

  • Grace software is used for visualisation of 2D data sets.
  • subversion is only if you wan't to checkout the source code.
  • matplotlib is not a necessity, but is likely to be implemented later for extended plotting.

RHEL 5 and compatible distributions

For RPM-based Linux distributions with access to the YUM installer, first install the relax dependencies with:

yum install python
yum install python-devel
yum install numpy
yum install scipy
yum install scons
yum install wxPython
yum install grace
yum install subversion
yum install python-matplotlib

If you do not have root access but are in the sudo group, then add a sudo before each of the above commands.

Minfx and Bmrblib

Remember to check, if there are newer versions of minfx and bmrblib.
The minfx and bmrblib libraries can be installed on all Linux systems by typing:

wget http://download.gna.org/minfx/minfx-1.0.5.tar.gz
tar -xzf minfx-1.0.5.tar.gz
cd minfx-1.0.5
python setup.py install
cd ..

wget http://download.gna.org/bmrblib/bmrblib-1.0.3.tar.gz
tar -xzf bmrblib-1.0.3.tar.gz
cd bmrblib-1.0.3
python setup.py install
cd ..

Testing the Python installation

Before installing relax, it is best to be sure that the Python modules are functional by importing them:

$ python
Python 2.6.6 (r266:84292, Oct 12 2012, 14:23:48)
[GCC 4.4.6 20120305 (Red Hat 4.4.6-4)] on linux2

>>> import wx
>>> wx.__file__
'...'

>>> import bmrblib
>>> bmrblib.__file__
'...'

>>> import minfx
>>> minfx.__file__
'...'


Checking out a relax branch

If you would like to play with relax branch rather than the main relax downloads, the Subversion program should first be installed.
You can see the different branches here.
First the relax sources can be checked out of the source code repository and the C modules compiled:

Using subversion

To check out the relax_disp branch using the subversion client, simply type:

svn co svn://svn.gna.org/svn/relax/branches/relax_disp relax_disp

If this svn command does not work, try:

svn co http://svn.gna.org/svn/relax/branches/relax_disp relax_disp


Compilation of the C modules

For the R1 and R2 and relaxation dispersion analyses, the relax C modules must be compiled. This is done using the scons program, by simply typing:

cd relax_disp
scons

You must be in the base relax directory for this to work. In addition, if you would like to compile the relax user manual, you can also use scons:

# Optional building of the user manual, if a LaTeX installation is available.
scons user_manual_pdf


Add to path - C_shell / Tcsh

cd relax_disp
echo "setenv PATH $PWD"':$PATH' >> $HOME/.cshrc

Restart the terminal, to load the new variables.

Start relax in GUI mode

relax -g

TEST INSTALLATION

After an installation you should really run an Installation_test

See also