seiscloud - software for seismicity clustering
You can not 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) 5 months ago
examples Updated config file examples 9 months ago
gx Added option for global plots, instead of regional. Default is regional. Code and manual updated. 5 months ago
src Renamed the norm space time plot (plot_norm_td) 5 months ago
.gitignore cleanup repository structure 1 year ago
README.md Added seiscloud manual to git repository 9 months ago
setup.py cleanup repository structure 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.