Rapid Earthquake Impact Assessment (REIA)

Overview

REIA works as an orchestrator to run seismic risk assessments using the OpenQuake engine. It stores and manages data in a PostgreSQL database, and allows for easy access via a webservice.

It provides the user with a structured workflow for configuring and running seismic risk assessments and evaluating the results. Reproducibility, persistence, and traceability of data and results are built into the software.

REIA is developed by the Swiss Seismological Service (SED) at ETH Zurich as part of the Swiss National Earthquake Risk Model (ERM-CH) project. It is operational in Switzerland to provide rapid earthquake impact assessments (example) after significant seismic events. Its detailed results are distributed to civil protection authorities and other stakeholders to support emergency response and recovery efforts.
The software is also used for scenarios in research projects, civil protection planning, and insurance applications.

Components

The REIA software consists of four main components:

1. A PostgreSQL database with PostGIS and pg_weighted_statistics extensions
2. An OpenQuake Engine instance
3. A webservice to access the data
4. This repository, containing the REIA CLI, configuration examples and base data.

Installation

Prerequisites

• Python ≥3.10 (optimally including python3.*-venv and python3.*-dev packages)
• Docker (official installation from https://docs.docker.com/engine/install/)

Installing the Services using Docker Compose

First, clone the repository:

git clone https://github.com/swiss-seismological-service/REIA.git
cd REIA

Then, copy the example environment file, which contains the necessary settings and credentials. A list with descriptions can be found here. The file can be left as is for a local setup, for a server installation you should edit the variables accordingly.
With a valid .env file, you can start the services using Docker Compose:

cp .env.example .env
docker compose up -d

Installing the CLI

All operations are performed via the REIA CLI tool. It can be installed in a virtual environment as follows:

python -m venv env
source env/bin/activate
pip install -e .
reia --help

Get started

After those installation steps, you can start using the REIA CLI to manage your data and run risk assessments. The first thing you need to do is to set up the database schema:

reia db migrate

Now you can add models, run calculations and risk assessments. Please refer to the Calculations document for more details.

Build a new version of the webservice

If you want to build a new version of the webservice and push it to the registry (for example after making changes to the code), you can do so by going to the Actions tab of this repository, selecting the publish workflow, and clicking on Run workflow. This will trigger the build and push process, and create a new image with the latest tag in the Docker registry.