Changes

=== The official way ===The most reliable way to install relax on your system is to use the official Python releases. The steps are:

=== Python === First check if you have the latest Python 2.7 installed, before installing the newest. Search in Spotlight for '''Terminal''', and write here<source lang="bash">which pythonpython --version</source>If needed, download the latest 2.7 version from the [http://www.python.org/download/ Official Python website].<br>This should be the DMG file labelled as '''Python 2.7.x Mac OS X 64-bit/32-bit x86-64/i386 Installer (for Mac OS X 10.6 and later)'''.<br>Open the DMG file, double click on the '''Python.mpkg''' file, and follow the instructions.<br>The most reliable way Python binary should now be located at '''/usr/local/bin/python'''. This is actually a symbolic link pointing to install '''/Library/Frameworks/Python.framework/Versions/2.7/bin/python'''. === Check out a relax branch ==={{historical svn}}You can see the different relax branches [http://svn.gna.org/viewcvs/relax on your system / here.]. '''Subversion''' is to use necessary, and should be shipped with [ http://subversion.apache.org/packages.html#osx OS X].<source lang="bash">which svnsvn --versioncd $HOME/Downloads</source>To check out trunk using the official Python releasessubversion client, simply type:<source lang="bash">svn co svn://svn.gna. The steps areorg/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>

# '''Python:''' First download the latest 2.7 version from the [http://www.python.org/download/ Official Python website].#* This should be the DMG file labelled as '''Python 2.7.x Mac OS X 64=== SCons -bit/32-bit x86-64/i386 Installer (for Mac OS X 10.6 and later)'''.building relax=== #* Open the DMG file, double click on the '''Python.mpkg''' file, and follow the instructions.#* The Python binary should now be located at '''/usr/local/bin/python'''. This is actually a symbolic link pointing required to '''/Library/Frameworks/Python.framework/Versions/2.7/bin/python'''.# '''wxPython:''' Download build the wxPython Development 2.9 DMG file from the [http://wxpython.org/download.php#unstable official wxPython website].#* The link should be called '''wxPython2.9-osx-cocoa-py2relax C modules.7'''.#* Open the DMG file, double click on the '''wxPython2.9-osx-cocoa-py2.7.pkg''' file, and follow the instructions.# '''Numpy:''' Download the latest Numpy DMG file from form the [http://sourceforge.net/projects/numpy/files/NumPy/ sourceforge download site].#* This should be the DMG file '''numpy-1.xwww.x-py2.7-pythonscons.org-macosx10.3.dmg'''.#* Open the DMG file, double click on the '''numpy-1.x.x-py2.7.mpkg''' file, and follow the instructions.# '''Scipy:''' Download the latest Scipy DMG file from the [http://sourceforge.net/projects/scipy/files/scipy/ sourceforge download site].#* This should be the DMG file '''scipy-0.xx.x-py2.7-python.org-macosx10.3.dmg'''.#* Open the DMG file, double click on the '''scipy-0.xx.x-py2.7.mpkg''' file or equivalent, and follow the instructions.# '''Mpi4py:''' 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 php SCons download site].#* Note, this will require an up to date version of XCode installed on your system, as the code will be compiled.#* Download the file labelled as called '''mpi4pyscons-12.x.x.tar.gz'''.<br>#** Open this through the Finder to unpackage the archive into the '''~/Downloads/mpi4pyscons-12.x.x/''' directory.<br>#** Open a terminal and type, replacing the x's with the current version, the following to get into the correct directory:<source lang="bash">cd $HOME/Downloads/scons-2.x.x</source>Then compile by:<source lang="bash">sudo python setup.py install</source>If you have several Python versions, then compile with the wished python interpreter by typing:

$ cd Downloadssudo /mpi4py-1Library/Frameworks/Python.xframework/Versions/2.7/bin/python setup.xpy install

$ sudo /Library/Frameworkswhich scons</Pythonsource> === First try to build relax ===To compile the C modules in relax, several packages must be in place, including the minfx package.framework/Versions/2<br>But we can just try to build relax now, and then solve the dependencies.7<source lang="bash">cd $HOME/binDownloads/python setup.py installrelax_trunk# Then buildscons

# '''SConsYou should get the message:''' 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 'The dependency 'minfx'scons-2.x.x.tar.gzhas not been installed'''. === Minfx and Bmrblib === # [[Minfx#* Open this through the Finder to unpackage the archive into the '''~/Downloads/scons-2.x.x/''' directory.Install | Minfx]]#* Open a terminal and type, replacing the x[[Bmrblib#Install | Bmrblib]] Let's with the current version, the following try to get into the correct directory:build again

cd $ cd HOME/Downloads/relax_trunkscons-1.x.x

#* Then to be sure If you get the correct Python version is being usedmessage '''-bash: gcc: command not found''', typeyou need to install [https://developer.apple.com/xcode/ Apple Xcode]. === Numpy ===First check if you have numpy installed in the current python installation.

$ sudo /Library/Frameworks/Pythonpythonimport numpynumpy.framework/Versions/2__version__; numpy.7/bin/__file__# Exit python setup.py installwith: Ctrl+d

#* If needed, download the latest Numpy DMG file from the [http://sourceforge.net/projects/numpy/files/NumPy/ sourceforge download site].<br>This will install scons into should be the DMG file '''/usr/local/bin/sconsnumpy-1.x.x-py2.7-python.org-macosx10.x.dmg'''.<br>#* To compile Open the C modulesDMG file, double click on the minfx package must be installed first'''numpy-1.x.x-py2.7. Please see belowmpkg''' file, and follow the instructions.

Now === wxPython ===First check if you will need to check that the correct Python and SCons versions are used when running relax or compiling have wxPzthon installed in the C modulescurrent python installation. This can be checked by typing the following:

$ sudo /usr/libexec/locate.updatedbpython$ which pythonimport wx$ locate python | grep '\/python$\|\/pythonwx.__version__; wx..$' | grep bin | xargs ls -alh__file__$ which scons$ locate python | grep '\/python$\|\/# Exit python...$' | grep bin | xargs ls -alhwith: Ctrl+d

The first command updated If needed, download the locate database, wxPython Development 2.9 DMG file from the '''which''' commands show which version of Python and SCons will [http://wxpython.org/download.php#unstable official wxPython website].<br>The link should be executed if called '''pythonwxPython2.9-osx-cocoa-py2.7''' or .<br>Open the DMG file, double click on the '''sconswxPython2.9-osx-cocoa-py2.7.pkg''' are typed at the promptfile, and follow the locate commands instructions. === Mpi4py ==={{note|This will show all require an up to date version of XCode installed versions of Python and SConson your system, as the code will be compiled.}} This is for running on multi-processor machines, for the analyses in relax which support it.

=== 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 ..

>>> wx.__version__; wx.__file__

>>> bmrblib.__version__; bmrblib.__file__

>>> minfx.__version__; minfx.__file__

== Checking out a relax branch Test Installation ==If {{tip|After an installation you would like to play with relax branch rather than the main should really run an [http://www.nmr-relax.com/download.html relax downloads], the [http://subversion.tigris.org/ SubversionInstallation_test] 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 Multiple Python versions ===<source lang="bash">cd /usr/local/binln -s /usr/local/relax_disp/relax .</source>Restart the terminalFor more details, to load the new variablessee [[Multiple Python versions]].

Start You will need to check that the correct Python and SCons versions are used when running relax in GUI modeor compiling the C modules. This can be checked by typing the following:

relax $ sudo /usr/libexec/locate.updatedb$ which python$ locate python | grep '\/python$\|\/python...$' | grep bin | xargs ls -galh$ which scons$ locate scons | grep '\/scons$' | grep bin | xargs ls -alh

= TEST INSTALLATION =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>After an installation Alternatively you should really run change your PATH environmental variable to have '''/usr/local/bin/''' at the start. SCons is always an [[Installation_test]]issue when multiple Python versions are installed.