Skip to content

Installation

Jump to bottom
AlexisMatter edited this page Oct 7, 2025 · 19 revisions

Installing the python scripts and the pipeline

The python scripts and IRBIS interface absolutely need the MATISSE pipeline to be installed. You must refer to the installation manual of the pipeline to get it installed prior to anything else. You may also refer to the alternative installation from a tar.gz file method by J. Isbell.

Getting the python scripts

Installation with pip

To use the main version of the python scripts, you can use pip.

pip install git+https://github.com/Matisse-Consortium/tools.git

Installing directly from the git repository (more for developers)

Download source code with git

git clone git@github.com:Matisse-Consortium/tools.git
cd tools
pip install .

Getting the IRBIS scripts

Section in progress

Alternative Installation (Manual)

Follow these instructions to install an updated recipe from a matisse-x.x.x.tar.gz file.

Note: Could not use "install_pipelinekit_devel" because it requires matisse*kit*.tar.gz format.

  1. Unzip the file with tar -xvf matisse-1.x.x.tar.gz
  2. cd into the new directory
  3. Run ./configure
    1. If this is in a non-standard path, use --prefix=/path/to/installation/location
    2. If your libraries (e.g., ERFA or CPL) are in non-standard locations, use --with-erfa=/path/to/erfa, etc. found in --help
  4. Run make PREFIX=/path/to/installation/location/<br>
    1. I had to add the directory with ERFA to my CPATH before this step
  5. Run make install PREFIX=/path/to/installation/location

Now we have to link this to esorex

  1. The default esorex settings are in /path/to/esorex/etc/esorex.rc. The relevant setting to change is on line 125, e.g. esorex.caller.recipe-dir=/path/to/above/installation/location. Ensure that the lib directory with the compiled recipes is in pathed directory
    1. Alternatively, run esorex --create-config and change the above setting in ~/.esorex/esorex.rc
  2. Check that everything is working with esorex --recipes. If recipes are doubled up, the old recipes are likely included in the recipe-dir path -- this is trivial to fix by moving the old recipe directory out of the path.
  3. Enjoy

Complete installation instructions from Philippe Berio

You need to install autoconf and libtool

On Ubuntu:

sudo apt-get install autoconf
sudo apt-get install libtool

CREATE YOUR INSTALLATION DIRECTORY

mkdir $HOME/MATISSE
cp matisse-1.4.6.tar.gz $HOME/MATISSE
tar xvzf matisse-1.4.6.tar.gz

Download gsl-1.15.tar.gz in $HOME/MATISSE 

tar xvzf gsl-1.15.tar.gz
cd $HOME/MATISSE/gsl-1.15
./configure --prefix=$HOME/MATISSE
make clean all install

Download fftw-3.3.3.tar.gz in $HOME/MATISSE 

tar xvzf fftw-3.3.3.tar.gz
cd $HOME/MATISSE/fftw-3.3.3
./configure --prefix=$HOME/MATISSE --enable-shared --with-pic
make clean all install

Download cfitsio3350.tar.gz in $HOME/MATISSE 

tar xvzf cfitsio3350.tar.gz
cd $HOME/MATISSE/cfitsio
./configure --prefix=$HOME/MATISSE --enable-reentrant
make clean all install

Download cpl-6.6.tar.gz in $HOME/MATISSE 

tar xvzf cpl-6.6.tar.gz
cd $HOME/MATISSE/cpl-6.6
./configure --prefix=HOME/MATISSE−−with−fftw=HOME/MATISSE --with-fftw=HOME/MATISSE−−with−fftw=HOME/MATISSE --with-cfitsio=$HOME/MATISSE
make clean all install

Download ERFA 

cd $HOME/MATISSE
git clone https://github.com/liberfa/erfa
cd $HOME/MATISSE/erfa
./bootstrap.sh
./configure --prefix=$HOME/MATISSE
make all install

Download esorex-3.12.tar.gz in $HOME/MATISSE 

tar xvzf esorex-3.12.tar.gz
cd esorex-3.12
./configure --prefix=HOME/MATISSE−−with−cpl=HOME/MATISSE --with-cpl=HOME/MATISSE−−with−cpl=HOME/MATISSE
cd $HOME/MATISSE/matisse-1.4.6
./configure --prefix=HOME/MATISSE−−with−cpl=HOME/MATISSE --with-cpl=HOME/MATISSE−−with−cpl=HOME/MATISSE --with-gsl=HOME/MATISSE−−with−erfa=HOME/MATISSE --with-erfa=HOME/MATISSE−−with−erfa=HOME/MATISSE
make clean all install

Clone this wiki locally