DASmrrcoh

Description

DASmrrcoh package is used to store the reproducible and open-access scripts for denoising DAS data using MRR and enhancing earthquake detection by COHerency measure.

Reference

If you find this package useful, please do not forget to cite the following paper.

Chen, Y., Savvaidis, A., Chen, Y., Saad, O.M., and Fomel, S., (2023). Enhancing earthquake detection from distributed acoustic sensing data by coherency measure and moving-rank-reduction filtering, Geophysics, 88(6), WC13-WC23, doi:10.1190/geo2023.0020.1.

BibTeX:

@article{dasmrrcoh,
  author={Yangkang Chen and Alexandros Savvaidis and Yunfeng Chen and Omar M. Saad and Sergey Fomel},
  title = {Enhancing earthquake detection from distributed acoustic sensing data by coherency measure and moving-rank-reduction filtering},
  journal={Geophysics},
  year=2023,
  volume=88,
  issue=6,
  pages={WC13-WC23},
  doi={10.1190/geo2023.0020.1},
}

Copyright

Authors of the dasmrrcoh paper, 2021-present

License

GNU General Public License, Version 3
(http://www.gnu.org/copyleft/gpl.html)

Install

Using the latest version

git clone https://github.com/chenyk1990/dasmrrcoh
cd dasmrrcoh
addpath(genpath('./')); #in Matlab command line

Examples

The "main" directory contains all runable scripts test_figNO.m to reproduce all figures in the paper.

Dependence Packages

MATdrr (https://github.com/aaspip/MATdrr)

Development

The development team welcomes voluntary contributions from any open-source enthusiast. 
If you want to make contribution to this project, feel free to contact the development team.

Contact

Regarding any questions, bugs, developments, collaborations, please contact  
Yangkang Chen
chenyk2016@gmail.com

NOTES:

To run the reproducible scripts (test_xxxx.m), please first download the required package from: https://github.com/chenyk1990/MATdrr.
Please put the MATdrr package in the main directory and add its sub-directories to the Matlab toolbox path.
The scripts beginning with "test_" are runnable scripts.
The script test_processall.m is the script that generates all the results in the folders processed and figresults.
The directory subroutines stores all the required subroutines.
The directory figresults stores all the results from the proposed denoising workflow.
The directory raw stores all the segmented multi-channel DAS seismic data at the SAFOD site.
The directory processed stores all the denoised DAS data.
The current version is based on Matlab. Future versions will also support Python and be optimized regarding computational efficiency.
All datasets used in these DEMO scripts or produced from massive processing based on this package are in a separate repository https://github.com/chenyk1990/dasmrrcoh-dataonly (for easier downloading).
The difference between the two "similar repositories" dasmrrcoh and dasmrrcoh-dataonly is that the latter is only used for storing the data (several GBs) and the former is only used for storing the scripts (less than 1 MB).
All figures (except for fig1, which is a schematic plot) in the DASmrrcoh paper are in the following directory for a quick look (https://github.com/chenyk1990/dasmrrcoh-dataonly/tree/main/gallery/).
The label fonts are different across different Matlab versions and platforms (Linux, Max). The figures presented in the paper are from Mac-Pro Matlab 2022b.

Gallery

The gallery figures of the DASmrrcoh package can be found at https://github.com/chenyk1990/dasmrrcoh-dataonly/tree/main/gallery/ Each figure in the gallery directory corresponds to a test_figNO.m script in the "main" directory with the exactly the same file name (figNO.png).

These gallery figures are also presented below.

Figure 2 Generated by test_fig2.m