Qseek

The friendly earthquake detector

Qseek is a data-driven earthquake detection and localisation framework for large seismic data sets. The framework is based on a stacking and migration approach, a beamforming method. It combines neural network phase annotations with an iterative octree localisation approach for efficient and accurate localisation of seismic events.

Key features are of the earthquake detection and localisation framework are:

• Earthquake phase detection using machine-learning model from SeisBench, pre-trained on different data sets.
  • PhaseNet (Zhu and Beroza, 2018)
  • EQTransformer (Mousavi et al., 2020)
  • OBSTransformer (Niksejel and Zahng, 2024)
  • LFEDetect
• Octree localisation approach for efficient and accurate search
• Different velocity models:
  • Constant velocity
  • 1D Layered velocity model
  • 3D fast-marching velocity model (NonLinLoc compatible)
• Extraction of earthquake event features:
  • Local magnitudes (ML), different attenuation models
  • Moment Magnitudes (MW) based on modelled peak ground motions
  • Different ground motion attributes (e.g. PGA, PGV, ...)
• Automatic extraction of modelled and picked travel times
• Station Corrections
  • station specific corrections (SST)
  • source specific station corrections (SSST)

Qseek is built on top of Pyrocko.

Documentation

For more information check out the documentation at https://pyrocko.github.io/qseek/.

Installation

Simple installation from GitHub.

pip install git+https://github.com/pyrocko/qseek

Project Initialisation

Show the default config.

qseek config

Edit the my-project.json

Start the earthquake detection with

qseek search search.json

Packaging

The simplest and recommended way of installing from source:

Development

Local development through pip.

cd qseek
pip3 install .[dev]

The project utilizes pre-commit for clean commits, install the hooks via:

pre-commit install

Citation

Please cite Qseek as:

Marius Paul Isken, Peter Niemz, Jannes Münchmeyer, Sebastian Heimann, Simone Cesca, Torsten Dahm, Qseek: A data-driven Framework for Machine-Learning Earthquake Detection, Localization and Characterization, Seismica, 2024, submitted

License

Contribution and merge requests by the community are welcome!

Qseek was written by Marius Paul Isken and is licensed under the GNU GENERAL PUBLIC LICENSE v3.