We cover first Debian-like distribution, then a generic recipie for all other version is given.
PyFAI has been designed and originally developed on Ubuntu 10.04 and debian6. Now, the pyFAI library is included into debian7, 8, 9 and any recent Ubuntu and Mint distribution. To install the package provided by the distribution, use:
sudo apt-get install pyfai
The issue with distribution based installation is the obsolescence of the version available.
To build a more recent version, pyFAI provides you a small scripts which builds a debian package and installs it. It relies on stdeb and provides a single package with everything inside. You will be prompted for your password to gain root access in order to be able to install the freshly built package.
sudo apt-get install python-stdeb cython python-fabio
wget https://github.com/silx-kit/pyFAI/archive/master.zip
unzip master.zip
cd pyFAI-master
./build-deb7.sh
Thanks to the work of Frédéric-Emmanuel Picca, the debian package of pyFAI provides a pretty good template which allows continuous builds.
You can automatically install the latest nightly built of pyFAI with:
wget http://www.silx.org/pub/debian/silx.list
wget http://www.silx.org/pub/debian/silx.pref
sudo mv silx.list /etc/apt/sources.list.d/
sudo mv silx.pref /etc/apt/preferences.d/
sudo apt-get update
sudo apt-get install pyfai
Nota: The nightly built packages are not signed, hence you will be prompted to install non-signed packages.
One can also built from sources:
sudo apt-get install cython cython-dbg cython3 cython3-dbg debhelper dh-python \
python-all-dev python-all-dbg python-fabio python-fabio-dbg python-fftw python-h5py \
python-lxml python-lxml-dbg python-matplotlib python-matplotlib-dbg python-numpy\
python-numpy-dbg python-qt4 python-qt4-dbg python-scipy python-scipy-dbg python-sphinx \
python-sphinxcontrib.programoutput python-tk python-tk-dbg python3-all-dev python3-all-dbg \
python3-fabio python3-fabio-dbg python3-lxml python3-lxml-dbg python3-matplotlib \
python3-matplotlib-dbg python3-numpy python3-numpy-dbg python3-pyqt4 python3-pyqt4-dbg \
python3-scipy python3-scipy-dbg python3-sphinx python3-sphinxcontrib.programoutput \
python3-tk python3-tk-dbg python-silx python3-silx
wget https://github.com/silx-kit/pyFAI/archive/master.zip
unzip master.zip
cd pyFAI-master
./build-deb8.sh
The first line is really long and defines all the dependence tree for building debian package, including debug and documentation. The build procedure last for a few minutes and you will be prompted for your password in order to install the freshly built packages. The deb-*files, available in the *package directory are backports for your local installation.
If your distribution does not provide you pyFAI packages, using the PIP way is advised, via wheels packages. First install pip and wheel:
sudo pip install pyFAI
Or you can install pyFAI from the sources:
wget https://github.com/silx-kit/pyFAI/archive/master.zip
unzip master.zip
cd pyFAI-master
python setup.py build test
sudo pip install . --upgrade
Nota: The usage of “python setup.py install” is now deprecated. It causes much more trouble as there is no installed file tracking, hence no way to de-install properly the package.