seiscloud - software for seismicity clustering
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
cesca 5adefa8aee Renamed the norm space time plot (plot_norm_td) 4 years ago
examples Updated config file examples 4 years ago
gx Added option for global plots, instead of regional. Default is regional. Code and manual updated. 4 years ago
src Renamed the norm space time plot (plot_norm_td) 4 years ago
.gitignore fixed a problem in the switch for clustering all events - now works properly 5 years ago Added seiscloud manual to git repository 4 years ago checked all modules with flake8, restructured files in directories and changed module names 5 years ago


Software for seismicity clustering.

  • Computation of similarity matrices upon different metrics
  • Clustering using DBSCAN algorithm
  • Graphical output of cluster features

Here a link to the Seiscloud logo

and to the Seiscloud manual

Please, contact me for further information and help:


Download and Installation

git clone
cd seiscloud
sudo python3 install


If you need help add a --help to the command call in order to get additional information.

If clustering steps need to be repeated use the --force option to overwrite previous results.

At first you need a configuration file for seiscloud. To create an example configuration file:

seiscloud example

Adapt the configuration file to your needs or build your own configuration file. The next step is to initialize your project:

seiscloud init <configuration_file>

The previous command will create a project directory and store there some important information (e.g. the seismic catalog). If a similarity matrix is already available this will also be stored in the project directory. Otherwise the similarity matrix can be computed according to the metric chosen in the configuration time (e.g. similarity in location, origin time, focal mechanism, moment tensor, ...):

seiscloud matrix <configuration_file>

Now, run the clustering:

seiscloud cluster <configuration_file>

Results, in the form of subcatalogs for each cluster, are stored as ascii file (pyrocko format) in the subdirectory clustering_results of the project directory.

And finally produce plots:

seiscloud plot <configuration_file>

Figures illustrative of the clustering results are stored as png or pdf files in the subdirectory clustering_plots of the project directory.