Distribution¶
To support users having problems to install CAESAR from source in their system we provide Docker and Singularity container recipe files and pre-built images with all software installed.
Docker base container¶
We assume here that Docker is available in your system. If not, install it following the instruction at https://docs.docker.com.
Recipe files to build a base Docker image with all CAESAR dependencies installed can be downloaded at: https://github.com/SKA-INAF/caesar-base-docker. For example the following command builds a Docker image on your system with name caesar/base (tag=latest) from Dockerfile.xenial:
docker build -t 'caesar/base:latest' -f 'Dockerfile.xenial' .
A pre-built Docker image (size approximately ~16 GB), ready to be used, can be download from Docker Hub using the following command:
docker pull sriggi/caesar-base
The image is built over a Ubuntu 16:04 (xenial) base OS image. Software dependencies are installed under the /opt/Software
directory.
A Docker container with CAESAR installed will be provided in the future.
Singularity container¶
We assume here that Singularity is available in your system. If not, install it from https://singularity.lbl.gov.
Recipe files to build the CAESAR singularity image can be downloaded at: https://github.com/SKA-INAF/caesar-singularity. Singularity image is built using the base Docker image described above. For example the following command builds a production container (e.g. non writable) on your system with name caesar.simg from a recipe file Singularity.xenial:
sudo singularity build caesar.simg Singularity.xenial
A pre-built container image (size approximately ~2 GB), ready to be used, can be download from Singularity Hub using the following command:
singularity pull --name caesar.simg shub://SKA-INAF/caesar-singularity:xenial
To enter the container type:
singularity shell caesar.simg
CAESAR is installed in the /opt/Software/CAESAR/trunk/
container directory. Software dependencies are installed under the /opt/Software
directory.
CAESAR applications are available for batch processing as Singularity apps. To list available apps type:
singularity apps caesar.simg
To run one of these applications (say with name APP_NAME and with input arguments APP_ARGS) type:
singularity run --app APP_NAME caesar.simg APP_ARGS
For example source finding (see Tutorial section) can be run inside container with:
singularity run --app sfinder caesar.simg --config=[FILE]