Download and Installation

Source Code Download

The MULASSIS source code distribution is available from the European Space Software Repository

Software Installation Requirements

The updated MULASSIS software has been developed and tested by Kallisto Consultancy under Linux Kubuntu version 22.04 LTS and Ubuntu version 22.04 LTS (i.e., Long Term Support version). The source code has been compiled and linked with the following software:

  • Geant4 v10.7 patch 03 (using internal CLHEP libraries)

  • GNU g++ v11.4.0

  • gmake v3.23.2

The MULASSIS software should be reasonably compatible with earlier versions of GNU g++ and gmake, provided the compiler is compatible with ISO Standard C++ 11 or later. ESA has built and tested MULASSIS v2.0 under Ubuntu 20.04.6 LTS with the following conditions:

  • Geant4 v10.7 patch 04 (using internal CLHEP libraries)

  • GNU g++ v9.4.0

  • gmake v3.16.3

Warning

It is assumed that the Geant4 v10.7 patch 03 library is implemented on the local system and the associated environment variables defined (please refer to webpages in references [R19][R20]).

Compilation, Build and Execution

From tar-gzipped distribution

If the MULASSIS source code is obtained as a tar-gzipped file (as in the case of downloads from the ESA ESSR website [R18]) the user should unpack the compressed file to the target source directory. For example, the tar-gzipped distribution file ml-v02-00.tar.gz will automatically unpack into the directory ml-v02-00, and executable is built and installed to /usr/local with the following commands:

cd ${HOME}
tar -xvzf <path_of_zipfile>/ml-02-00.tar.gz
cd ml-v02-00
mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local \
         -DCMAKE_BUILD_TYPE=<build_type>
make -j<n>
sudo make install
In the above commands:

  • <build_type> is either Release or Debug;

  • <n> is the number of processor cores to use for the make process.

It is recommended that the directory of the MULASSIS executable is added to your $PATH environment if not already included, and is also included in the initialisation performed by your cshrc or bashrc script.

From MULASSIS Repository

Assuming that the MULASSIS source code is to be installed in directory ${HOME}/ml-v02-00 and executable installed in /usr/local/bin, the commands to download, compile and build the software are:

mkdir ${HOME}/ml-v02-00
cd ${HOME}/ml-v02-00
svn checkout --username <username> --password <password> \
https://spitfire.estec.esa.int/svn/Mulassis/<svn_version> .
mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local \
         -DCMAKE_BUILD_TYPE=<build_type>
make -j<n>
sudo make install
In the above commands:

  • <username> and <password> are the credentials for SVN access;

  • <svn_version> is the version of MULASSIS to build, e.g., trunk or tags/ml-v02-00;

  • <build_type> is either Release or Debug;

  • <n> is the number of processor cores to use for the make process.

Again, it is recommended that $PATH is modified to include the MULASSIS target directory.

Bug reporting

Mulassis/ml-v02-00/r342