Installing the development version

The current development version of the code can be downloaded as source tarballs, Mac OS X binaries, or directly from the Git repository.

The current ctools development release is ctools-2.0.0.dev.

Source tarballs

Download the source tarballs from the following links

and follow the instructions on Installing from source code.

Binary packages

Download the installer image from the following link

and follow the instructions on Installing as binary package.

Git repository

To clone the gammalib and ctools source codes, type

$ git clone https://cta-gitlab.irap.omp.eu/gammalib/gammalib.git
$ git clone https://cta-gitlab.irap.omp.eu/ctools/ctools.git

This will create directories named gammalib and ctools under the current working directory that will contain the gammalib and ctools source code. In case that the cloning does not work you may try adding

$ export GIT_SSL_NO_VERIFY=true

or

$ git config --global http.sslverify "false"

before retrieving the code. Before you will be able to compile the code you need to generate the configuration file using the autogen.sh script. Also make sure that you’re actually on the devel branch of the git repository. GammaLib and ctools can be compiled and configured using the following command sequence (the code will be installed into the /usr/local/gamma directory):

$ cd gammalib
$ git checkout devel
$ ./autogen.sh
$ ./configure
$ make
$ make check
$ sudo make install
$ export GAMMALIB=/usr/local/gamma
$ source $GAMMALIB/bin/gammalib-init.sh
$ cd ../ctools
$ git checkout devel
$ ./autogen.sh
$ ./configure
$ make
$ make check
$ sudo make install
$ export CTOOLS=/usr/local/gamma
$ source $CTOOLS/bin/ctools-init.sh

Please read the Installing from source code section if you need more information on how to install ctools.

Note

You need swig on your system to build the Python wrappers when you get the code from Git. Python wrappers are not stored in the Git repository but are built using swig from interface files located in the pyext folder. However, you do not need swig when fetching a release as the Python wrappers are bundled with the release tarballs.

Making a conda package

To create a conda package for the development version, clone the gammalib and ctools source codes using

$ git clone https://cta-gitlab.irap.omp.eu/gammalib/gammalib.git
$ git clone https://cta-gitlab.irap.omp.eu/ctools/ctools.git

and type the following to create the conda packages (make sure that anaconda is included in your $PATH environment):

$ cd gammalib
$ git checkout devel
$ ./autogen.sh
$ ./configure
$ conda-build dev/conda.recipe
$ cd ../ctools
$ git checkout devel
$ ./autogen.sh
$ ./configure
$ conda-build dev/conda.recipe

Once this is done, you can create a conda environment using the development version as follows:

$ conda create -n ctools-devel python=3.6
$ source activate ctools-devel
$ conda install --use-local ctools=2.0.0.dev

Note that you can choose between Python 2.7, 3.5, 3.6, 3.7 and 3.8 for your conda environment.