Skip to content

Welcome to


SurfQuake has been designed to streamline the workflow of estimating seismic source parameters. Comprehensive set of toolboxes automates the determination of arrival times, event locations, event magnitudes , attenuation, and moment tensor inversion. The software is programmed in Python 3 and offers the users the possibility of three programming levels for flexibility and customization.

  • The Core Library allows users to integrate the core of surfQuake into their preexisting scripts, giving advanced users full control.

  • The Command Line Interface gives users access to an upper layer that simplifies the use of the core, enabling task execution through simple commands.

  • The Graphical User Interface (GUI): Wraps the SurfQuake core in a user-friendly interface, making it accessible to users who prefer visual interaction. The GUI is connected to a SQLite database to store all results, ensuring easy retrieval and management of data.



How to follow surfQuake Tutorial

The first step is to select which programming level is the most convenient for you. SurfQuake is divided into five Toolboxes: Picking, Association, Locate, Source, and Moment Tensor Inversion (MTI). Each toolbox link below contains a description of the software according to your programming level and an example.

Let's start with Project and then continue with the next toolboxes.

Case of Study and Supporting Materials

First: Case of study, contains a full example of using surfQuake with core Library Python scripts, Core Library bash script and expected results. Of course you can try to run the example using the GUI.

Second: Earth Velocity models examples. Event Location format and MTI format.

Cite surfQuake:

While we finish the paper, you can cite surfQuake by referencing the parent software ISP.

Cite us: Integrated Seismic Program (ISP) A New Python GUI‐Based Software for Earthquake Seismology and Seismic Signal Processing. Seismological Research Letters 2022

or cite the EGU24 presentation:

Cabieces, R., Junqueira, T. C., and Relinque, J.: SurfQuake (SQ): A new Python toolbox for the workflow process of seismic sources, EGU General Assembly 2024, Vienna, Austria, 14–19 Apr 2024, EGU24-2816,, 2024.