seiscloud - software for seismicity clustering

cesca f5e1a9f821 Fixed some calles to distance calculations, now passing conf where needed 1 day ago
examples 3ec3401609 Updated config file examples 4 months ago
gx 46664765bb Added again the option to define the maximal considered spatial and temporal distances mapping into the max value 1.0 1 day ago
src f5e1a9f821 Fixed some calles to distance calculations, now passing conf where needed 1 day ago
.gitignore 516f39545e fixed a problem in the switch for clustering all events - now works properly 10 months ago e948c0b384 Added seiscloud manual to git repository 4 months ago 4dbbfead2c checked all modules with flake8, restructured files in directories and changed module names 1 year 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.