seiscloud - software for seismicity clustering

Simone Cesca 8485215517 fixed a bug in seiscloud.py 1 week ago
examples 3ec3401609 Updated config file examples 2 months ago
gx e948c0b384 Added seiscloud manual to git repository 2 months ago
src 8485215517 fixed a bug in seiscloud.py 1 week ago
.gitignore 516f39545e fixed a problem in the switch for clustering all events - now works properly 9 months ago
README.md e948c0b384 Added seiscloud manual to git repository 2 months ago
setup.py 4dbbfead2c checked all modules with flake8, restructured files in directories and changed module names 1 year ago

README.md

Seiscloud

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: simone.cesca@gfz-potsdam.de

Prerequisites

Download and Installation

git clone https://git.pyrocko.org/cesca/seiscloud.git
cd seiscloud
sudo python3 setup.py install

Processing

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.