Skip to content

sgrubas/cats

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cluster Analysis of Trimmed Spectrograms (CATS)

CATS is a signal processing technique and framework for detecting and denoising sparse signals in the time-frequency domain. Particularly, very useful for processing earthquakes. This work is still in progress, and the package is under active development. Soon, here will be links to our papers/preprints.

Key features of CATS

  • Versatile. Any signals (not necessarily seismic) that are sparse in the time-frequency domain can be localized by CATS.
  • Flexible. Any time-frequency transform can be used as a base (STFT, CWT, ...). Fast detection with STFT or more accurate denoising with CWT.
  • Fast and accurate. Here will be links to our papers showing this.
  • Transparent and QC-friendly.
    • Minimum number of parameters which are easy to autotune.
    • Interpretable and visualizable workflow steps and parameters.
    • Collected cluster statistics can be used for custom post-processing and quality control (QC).

Installation

There are two ways to install the package:

  1. pip install git+https://github.com/sgrubas/cats.git

    1. Clone repository: git clone https://github.com/sgrubas/cats.git
    2. Open the cats directory with setup.py file
    3. Install: python setup.py install or python setup.py develop (for the flexible development mode)

Dependencies

The package was tested on Python 3.9. See other dependencies in requirements.txt.

Tutorials

Demos:

Signal detection with CATSDetector

Signal denoising with CATSDenoiser and CATSDenoiserCWT

Citation

If you find CATS useful for your research, please cite our paper:

@article{grubas2023cats,
title = {Seismic event detection via cluster analysis of trimmed spectrograms},
journal = {TBC},
volume = {TBC},
pages = {TBC},
year = {2024},
issn = {TBC},
doi = {TBC},
url = {TBC},
author = {Serafim Grubas and Mirko van der Baan},
keywords = {TBC}
}

Authors

About

Cluster Analysis of Trimmed Spectrograms: framework for detection and denoising of sparse signals in time-frequency domain.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published