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.