Installation

This guide covers the necessary steps to set up your environment for the Simulation Platform. You will need to install Python dependencies and system-level tools like the Generic Mapping Tools (GMT). Also, the tutorials rely on the OpenQuake Model Building Toolkit (oq-mbtk) for seismic catalogue processing and statistical analysis. Before proceeding, you must have oq-mbtk installed.

Here we demonstrate the installation of the QuakeT and its necessary dependencies, respectively.

Get the QuakeT Source Code

Open a terminal and move to the folder where you intend to install the tools;

Clone the repository using the web URL of QuakeT repository:

git clone https://github.com/GEMScienceTools/quakeT.git

Go to the folder where you cloned the QuakeT repository and make it in “editable” mod running the following command:

pip install -e .

OpenQuake MBTK Setup

Please follow the official installation instructions of oq-mbtk here: OpenQuake MBTK Installation Guide.

Python Environment Setup

It is highly recommended to use a virtual environment (conda or venv) to avoid dependency conflicts.

# Create and activate a virtual environment (optional)
python -m venv quaket_env
source quaket_env/bin/activate  # On Windows: quaket_env\Scripts\activate

# Install Python libraries
pip install pandas geopandas shapely matplotlib ipython

System Requirements

The spatial distribution tutorials require GMT to be installed on your operating system.

macOS

The easiest way to install these tools on macOS is using Homebrew:

brew install gmt

Windows

GMT: Download and run the executable installer (.exe) from the GMT Official Releases. During installation, ensure you check the box “Add GMT to the system PATH”.
Ghostscript: (Required by GMT for PNG output) Download and install from the Ghostscript site.

Linux

Use the package manager to install the required tools:

sudo apt update
sudo apt install gmt gmt-dcw gmt-gshhg

Verification

After installation, verify that the tools are correctly set up by running these commands in your terminal or command prompt:

gmt --version

Note

If you receive a “command not found” error, you may need to restart your terminal or manually add the installation folders to your system’s Environment Variables (PATH).