Short Installation instructions

BEAT can be installed on any Unix based system with python>=3.8 that supports its prerequisites.

Please consider to use virtual environments to lower the risk of package conflicts.

Install and create a virtual environment

Install the virtual environment package:

sudo apt install python-venv

Create a directory virtualenvs where you want to keep your virtual environments, e.g. in user home:

cd ~
mkdir virtualenvs
cd virtualenvs

Create new environment e.g. beat_env and activate it:

python3 -m venv beat_env
source ~/virtualenvs/beat_env/bin/activate

The environment can be (later) deactivated NOT NOW!, with:


Now we have created the beat_env environment into which we will install all the needed packages. Thus, we can avoid potential versioning conflicts with other packages.

Install beat, latest release

In the activated environment we install the latest release of beat through the package manager pip:

pip3 install beat

Install beat, development version

Get the development version through the github repository:

cd ~/src  # or wherever you keep the packages
git clone
cd beat
git pull origin master
pip3 install .

Greens Function calculations

To calculate the Greens Functions we rely on modeling codes written by Rongjiang Wang. If you plan to use the GreensFunction calculation framework, these codes are required and need to be compiled manually. The original codes are packaged for windows and can be found here.

For Unix systems the codes had to be repackaged.

The packages below are also github repositories and you may want to use “git clone” to download:

git clone <url>

This also enables easy updating for potential future changes.

For configuration and compilation please follow the descriptions provided in each repository respectively.

Seismic synthetics

Geodetic synthetics