Mondaic - Full Waveform Solutions

Installing Salvus is a multi-step procedure that is slightly different on every system. This page describes the recommended sequence in case you are new to using Salvus.

If you run into any problems please don't hesitate to contact us at [email protected] or any other provided support channel.

Salvus is officially supported on Apple's macOS as well as most Linux distributions. Running on the Windows Subsystem for Linux on Windows 10 is possible by following these instructions, but Mondaic does not officially support it as of now.

We recommend the following 5 steps to install Salvus. This page contains a summary of them - each step is additionally detailed on its own page.

Details on where to run Salvus: Where to Run Things?

The first step to install Salvus is to figure out where every component of it will run. The most common case is to have a full installation locally and additionally install a version of SalvusCompute on a larger workstation or cluster.

Details on the Python installation: Python Packages

Salvus depends on Python and a number of third party packages. We recommend to use the Miniconda distribution together with Mamba as package manager: First, install Miniconda from here. Next, install Mamba in the base environment

Copy
conda install -c conda-forge mamba --yes

After installing both, please run the following commands to create a Salvus environment and install all dependencies:

Copy
# Download the environment description file.
curl https://mondaic.com/environment.yml -o environment.yml
# Create a new environment with all required dependencies.
mamba env create -n salvus -f environment.yml
# Activate that environment.
conda activate salvus

Details on the Mondaic Downloader: Mondaic Downloader

To download Salvus and install the Salvus Python module run the following two commands:

Copy
# Run the Mondaic downloader.
bash -c "$(curl -sSL https://get.mondaic.com)"
# Install the Python Salvus package into the previously created python
# environment.
pip install ~/Salvus/python_packages/salvus-*.whl