scdlpicker

SeisComP/SeisBench interface to enable deep-learning (re)picking in SeisComP

Objective

This is a simple deep learning (DL) repicker module for SeisComP based on SeisBench.

Right now, the DL repicker module performs repicking of previously located events. In other words, it looks for picks at known or estimated times in seismograms and tries to determine accurate arrival times or even detect new arrivals. It does not work on continuous streams.

The DL repicker is written in Python and consists of four modules:

• scdlpicker-client

This is the communication module that connects to a SeisComP system (messaging) and listens for interesting objects (origins, picks). It writes them to a YAML file, which is then processed by the repicker module.

• scdlpicker-repicker

This is the actual repicker. Whenever the SeisComP client writes out a new YAML file with picks, it will reprocess these picks. The results will in turn be written to a YAML file where they are picked up by scdlpicker.client.py.

• scdlpicker-relocate-event

A simple relocator for SeisComP, to be used on the command line. For a given event location it simply reads DL picks from the database and attempts to obtain a reasonable event location, which is then sent to the SeisComP system. Note that this is now fully automated by either running scdlpicker-online-relocator continuously. In future it is planned to also extend scautoloc to be able to properly process DL picks.

• scdlpicker-online-relocator

Another simple relocator for SeisComP, to be used on the online line. It automates the functionality of scdlpicker-relocate-event.

Requirements

• Python 3
• SeisComP incl. Python wrappers
• SeisBench
• ObsPy

Build requirements

Can be built with either

• python3-setuptools
• python3-distutils-extra
• as part of the SeisComP build using cmake.

Installation

To install, you simply run python setup.py install.

You need to have installed SeisBench previously.

Note that there is no uninstall script.

Disclaimer

This package is work in progress and provided "as is" in the hope that some users will find it useful for their work. No guarantee can be given that it will work in all circumstances or produce improved results. Interfaces may change without notice. Especially the YAML interface between the two main modules is rather ad hoc and will likely be modified, which is will be no problem as long as no other modules depend on the details.

The package is not intended to be a turn-key solution and no support can be provided. Feedback in the form of bug reports or enhancement is of course greatly appreciated.

Authors & Acknowlegements

The DL repicker was written by Joachim Saul and Thomas Bornstein. The software depends heavily on SeisBench, which was written by Jannes Münchmeyer and Jack Wollam.

Reference publications for SeisBench:

• SeisBench - A Toolbox for Machine Learning in Seismology

  Reference publication for software (pre-print).

• Which picker fits my data? A quantitative evaluation of deep learning based seismic pickers

  Example of in-depth bencharking study of deep learning-based picking routines using the SeisBench framework.