Installation

The current stable version of the Tamasis/PACS package is 4.2.
The project is hosted at github and there are two ways to obtain it.

• Either by retrieving an archive
  – as a tar file
  – or a zip file.
  
  
• Alternatively, by cloning the project, using the version control system Git:

$ git clone git://github.com/pchanial/tamasis-pacs.git tamasis-4.2 --branch=v4.2

The second method is more convenient to make updates of the branch (if you’ve just cloned the repository, you will obviously not get anything new) or (without specifying the --branch=v4.2 option) to follow developments on or contribute to the master branch.

$ cd tamasis-4.2
$ git pull
Already up-to-date.

This method is also required if you are to test tamasis’ development branch.

Setting up a scientific Python environment

Installing a Python environment for scientific purposes can be a hassle. I recommend installing a dedicated distribution such as Enthought or Python (x,y). If you’re up to the challenge of setting it up by yourself, you should install the following packages:

• python >= 2.6 (< 3)
• numpy >= 1.6
• scipy >= 0.9
• matplotlib >= 0.99
• numexpr >= 2.0
• pyfits >= 3.0
• optional, but recommended: ipython

Tamasis dependencies

Compiler

• either gfortran >= 4.5
• or ifort >= 11.1

External libraries

• cfitsio >= 3.23
• FFTW >= 3.2.2 (compiled with options --enable-threads and --enable-shared)

• optional, for a distributed installation: openmpi or mpich

Python modules

• pyoperators >= 0.4
• pyfftw >= 0.2.1
• kapteyn >= 2.0.2

• optional, for a ds9 interface: pyds9
• optional, for a distributed installation: mpi4py

Installation

Once all the dependencies are installed, type

$ ./waf configure --prefix=/path/to/local build install test

Then, to make sure that the stack size of an OpenMP thread is large enough to handle a map, you should add to your .bashrc/.bash_profile file the following lines:

export OMP_STACKSIZE=2g
ulimit -s unlimited

Troubleshooting

• If you’re using the Enthought Python Distribution, there are symbol conflicts between the fftw3 library and the mkl library. Since the mkl library does not provide a backend for half complex operations, these will fail. To force the fftw library to be loaded before the mkl library, I set the following environment variable (check the fftw3 installation path):

export LD_PRELOAD=/usr/local/lib/libfftw3.so:/usr/local/lib/libfftw3f.so

• if you have installed libraries in a non-standard location, make sure that the environment variable LD_LIBRARY_PATH (Linux) or DYLD_LIBRARY_PATH (MacOSX) contains the path of these libraries.

• if Python 3 is your default python interpreter (in Archlinux, for instance) and assuming that the Python 2 interpreter is ‘python2’, you can run the following command in bash:

PYTHON=python2 python2 waf configure --prefix=~/local build install test