Trusted, Bureaucrats
4,223
edits
Changes
→Check out a relax branch: Transclusion of the {{historical svn}} template.
How to install relax on Mac OS X systems.
== Installing the relax dependencies ==
=== Check out a relax branch ===
{{historical svn}}
You can see the different relax branches [http://svn.gna.org/viewcvs/relax/ here.]. '''Subversion''' is necessary, and should be shipped with [ http://subversion.apache.org/packages.html#osx OS X].
<source lang="bash">
cd $HOME/Downloads
</source>
To check out the relax_disp or trunk branch using the subversion client, simply type:
<source lang="bash">
svn co svn://svn.gna.org/svn/relax/trunk relax_trunk
</source>
If this svn command does not work, try:
<source lang="bash">
svn co http://svn.gna.org/svn/relax/trunk relax_trunk
</source>
=== SCons - building relax===
This is required to build the relax C modules. Download the file form the [http://www.scons.org/download.php SCons download site].
** Download the file called '''scons-2.x.x.tar.gz'''. <br>
This should install scons into '''/usr/local/bin/scons'''. <br>
<source lang="bash">
which sconesscons</source> === First try to build relax ===To compile the C modules in relax, several packages must be in place, including the minfx package.<br>But we can just try to build relax now, and then solve the dependencies.<source lang="bash">cd $HOME/Downloads/relax_trunk# Then buildscons
</source>
=== Numpy ===
=== Mpi4py ===
{{note|This is for running on multi-processor machines, for the analyses in relax which support it. Download the file from the [https://code.google.com/p/mpi4py/downloads/list mpi4py download site]. <br>Note, this will require an up to date version of XCode installed on your system, as the code will be compiled.<br>}}Download the file labelled as '''mpi4py-1.x.x.tar.gz'''.<br>Open this through the Finder to unpackage the archive into the '''~/Downloads/mpi4pyThis is for running on multi-1.x.x/''' directory.<br>Open a terminal and typeprocessor machines, replacing for the x's with the current version, the following to get into the correct directory: <source lang="bash">$ cd ~/Downloads/mpi4py-1analyses in relax which support it.x.x </source><br>Then to be sure the correct Python version is being used, type:# [[Mpi4py#Install | Mpi4py]]
<source lang="bash">
$ sudo /Library/Frameworks/Python.framework/Versions/2.7/bin/python setup.py install
pip install numpy
=== Minfx and Bmrblib == Remember to check if there are newer versions of [http://download.gna.org/minfx minfx] and [http://download.gna.org/bmrblib bmrblib]. <br>The [https://gna.org/projects/minfx/ minfx] and [https://gna.org/projects/bmrblib/ bmrblib] libraries can be installed on all Linux systems by typing:<source lang="bash">wget http://download.gna.org/minfx/minfx-1.0.5.tar.gztar -xzf minfx-1.0.5.tar.gzcd minfx-1.0.5python setup.py installcd ..
Note that if you have multiple Python versions, the correct one must be specified. It is best to use the full Python path, for example:
>>> import wx
>>> wx.__version__; wx.__file__
'...'
>>> import bmrblib
>>> bmrblib.__version__; bmrblib.__file__
'...'
>>> import minfx
>>> minfx.__version__; minfx.__file__
'...'
</source>
== Checking out a relax branch ==If you would like to play with relax branch rather than the main [http://www.nmr-relax.com/download.html relax downloads], the [http://subversion.tigris.org/ Subversion] program should first be installed. <br>You can see the different branches [http://svn.gna.org/viewcvs/relax/ here.] <br>First the relax sources can be checked out of the source code repository and the C modules compiled:<source lang="bash">cd /usr/local/svn co svn://svn.gna.org/svn/relax/branches/relax_disp relax_dispcd relax_dispscons # Optional building of the user manual, if a LaTeX installation is available.scons user_manual_pdf</source> If the svn command does not work, try:<source lang="bash">svn co http://svn.gna.org/svn/relax/branches/relax_disp relax_disp</source> === Add relax to path ===<source lang="bash">cd /usr/local/binln -s /usr/local/relax_disp/relax .</source>Restart the terminal, to load the new variables. Start relax in GUI mode<source lang="bash">relax -g</source> == TEST INSTALLATION Test Installation =={{tip|After an installation you should really run an [[Installation_test]]}}
== Trouble shooting ==
</source>
The first command updates the locate database, the '''which''' commands show which version of Python and SCons will be executed if '''python''' or '''scons''' are typed at the prompt, and the locate commands will show all installed versions of Python and SCons.
You may still have 'minfx' installation problems when compiling the C modules if multiple Python version are present. <br>
So it is recommended to open the '''/usr/local/bin/scons''' file and change the first line from '''/usr/bin/env python''' to '''/usr/local/bin/python''' so that the correct Python version is used.<br>
Alternatively you change your PATH environmental variable to have '''/usr/local/bin/''' at the start. SCons is always an issue when multiple Python versions are installed.
== See also ==
[[Category:Installation]]