PyCBC installation instructions
===============================

Prerequisites
-------------

* LALSuite
  See https://www.lsc-group.phys.uwm.edu/daswg/docs/howto/lal-install.html
  for instructions to install through source, or simply install the pre-built
  version hosted on pypi using pip.

Installing PyCBC
----------------

    pip install lalsuite pycbc
    
Installing CUDA Python modules
------------------------------

For GPU acceleration through CUDA:

* Nvidia CUDA >= 4.0 (driver and libraries).

* PyCUDA >= 2013.1.1 - http://mathema.tician.de/software/pycuda
  See next section for instructions.

* SciKits.cuda >= 0.041 - http://scikits.appspot.com/cuda
  See next section for instructions.

* Mako >= 0.7.2 - http://www.makotemplates.org
  See next section for instructions.

These packages may not be available via the distribution packaging system,
at least in the required versions. Although they should be generally
installable via pip or easy_install, this method is not always available
on LSC clusters. Therefore, we report general instructions for installing
from source on your ~/.local directory.

PyCUDA:
    git clone http://git.tiker.net/trees/pycuda.git
    cd pycuda
    git submodule init
    git submodule update
    ./configure.py
    python setup.py build
    python setup.py install --user

If your CUDA installation is in a non-standard location X,
pass --cuda-root=X to configure.py.

SciKits.cuda:
    Get the tarball (http://pypi.python.org/pypi/scikits.cuda) and unpack it.
    cd scikits.cuda*
    python setup.py install --user

Mako:
    Get the tarball (http://www.makotemplates.org/download.html) and unpack it.
    cd Mako*
    python setup.py install --user

To install system-wide rather than to ~/.local, change the 'setup.py install'
commands to
    sudo python setup.py install