Skip to content

pyrocko/qseek

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Qseek

Data-driven Earthquake Detection

uv ruff prek Python 3.12+ PyPI - Version Documentation

Qseek is a an automatic, data-driven earthquake detection and localisation tool designed for large seismic data sets. It combines neural network phase annotations with a stacking-and-migration and an adaptive octree localisation approach.

Key features are:

  • Earthquake phase detection using machine-learning model from SeisBench, pre-trained on different data sets:
  • Travel time calculation:
    • 1D Layered velocity model (Pyrocko Cake and Fast Marching)
    • 3D fast-marching velocity model (NonLinLoc compatible)
    • Constant velocity
  • Earthquake magnitudes and other features:
    • Local magnitudes (ML) with different attenuation models
    • Moment Magnitudes (MW) based on modelled attenuation curves (Dahm et al., 2024)
    • Ground motion attributes (e.g. PGA, PGV, ...)
  • Station Corrections
    • SST: station specific corrections
    • SSST: source specific station corrections

Qseek is built on top of Pyrocko.

Documentation

Online documentation is available at https://pyrocko.github.io/qseek/.

Installation

From PyPi.

pip install qseek

Installation from GitHub.

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

Project Initialisation

Print the default config with

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
uv pip install -e .

The project utilizes prek for clean commits, install the hooks via:

prek install

Citation

Please cite Qseek as:

Isken, M., Niemz, P., Münchmeyer, J., Büyükakpınar, P., Heimann, S., Cesca, S., Vasyura-Bathke, H., & Dahm, T. (2025). Qseek: A data-driven Framework for Automated Earthquake Detection, Localization and Characterization. Seismica, 4(1). https://doi.org/10.26443/seismica.v4i1.1283

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.

About

The earthquake detection and localization framework 🔥

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •