Appion

h1. Install supporting packages

Using the Required Supporting Packages table below, install any missing prerequisite packages by following the instructions for your specific Linux distribution.

For example, SUSE users can use YaST to install them; RedHat and CentOS users can use @yum@, Debian and Ubuntu uses @apt-get@. 

We highly recommend using pre-built binary packages to install the programs. Installing from source can quickly become a nightmare! See also the previous page, [[appion:Instructions_for_installing_CentOS_on_your_computer]] for Red Hat based systems.

h3.  Required supporting packages:

|_.Name:|_.Download site:|_.yum package name|_.SuSE rpm name|_.Debian 8 package name|

|Python 2.6 or newer| "http://www.python.org":http://www.python.org|python|python-devel|python|

|wxPython 2.5.2.8 or newer| "http://www.wxpython.org":http://www.wxpython.org|wxPython|python-wxGTK|python-wxgtk3.0|

|MySQL Python client 1.2 or newer| "http://sourceforge.net/projects/mysql-python":http://sourceforge.net/projects/mysql-python|MySQL-python|python-mysql|python-mysqldb|

|Python Imaging Library (PIL) 1.1.4 or newer| "http://www.pythonware.com/products/pil/":http://www.pythonware.com/products/pil/|python-imaging|python-imaging|python-pil|

|NumPy 1.0.1 or newer| "http://numpy.scipy.org/":http://numpy.scipy.org/|numpy|numpy|python-numpy|

|SciPy 0.5.1 (tested, others may work)*| "http://www.scipy.org":http://www.scipy.org|scipy|python-scipy|python-scipy|

|joblib 0.8.3-r1 or newer| "https://pypi.python.org/pypi/joblib":https://pypi.python.org/pypi/joblib|python-joblib|python-joblib|python-joblib|

joblib can be installed with the command

<pre>

easy_install joblib

</pre>

If you use Python 2.4 or earlier, you also need to install the "PyXML module":http://pyxml.sourceforge.net/topics/ .  For more recent versions of Python, it is already included in the main Python package.

For CentOS, see [[appion:Download additional Software]] page, if you have trouble finding these packages.

h3.  Scipy/Numpy

h4. SUSE specific issues

* SciPy may not build from source properly on some versions of SuSE due to an incompatible LAPACK package that comes with SuSE. You can get scipy as well as a compatible LAPACK etc. from http://repos.opensuse.org/science (need to specify your SuSE version and machine etc.)

* See also https://bugzilla.redhat.com/show_bug.cgi?id=489887 regarding LD_LIBRARY_PATH restriction to LAPACK installation.

You can test your numpy and scipy install with their build in test functions:

<pre>

python -c 'import numpy; numpy.test(level=1)'

python -c 'import scipy; scipy.test(level=1)'

</pre>

Numpy is more stable should be successful. Expect to see lots of errors with scipy.

h3.  Mac OS X 10.5+:

You can successfully install most of these packages on a Mac by downloading DMG files and clicking on the install programs. This is not for novice Mac user.  Be warned, wxpython problems on Mac will make your life difficult in using Leginon gui.  Don't make your mac the only processing server if it is Leginon that you will use mainly.

# First, start by downloading the @Mac OS X Installer Disk Image@ (v2.6 recommended) from http://python.org/download/ and install the newer version of python

# Download and install numpy and scipy DMG files from http://sourceforge.net/projects/numpy/files/ and http://sourceforge.net/projects/scipy/files/

# Download and install wxPython DMG file from http://www.wxpython.org/download.php

Other program need more work:

# The Python Imaging Library (PIL) has be compiled from source, which also requires the "Mac OS X Developer tools":http://developer.apple.com/technologies/tools/ to be installed.