Skip to content

ROBelgium/MSNoise

Repository files navigation

MSNoise

A Python Package for Monitoring Seismic Velocity Changes using Ambient Seismic Noise.

CI Builds: Github Action Status codecov

PyPI: PyPI version PyPI downloads

Conda: Conda Downloads Conda Version Conda Platforms

MSNoise is the first complete software package for computing and monitoring relative velocity variations using ambient seismic noise. MSNoise is a fully-integrated solution that automatically scans data archives and determines which jobs need to be done whenever the scheduled task is executed.

MSNoise is developed by Thomas Lecocq (Royal Observatory of Belgium, ROB). Corentin Caudron used MSNoise during his PhD at ROB and still continuously provides invaluable debug information. The group of active users (providing questions, feedback, snippets of code) is growing and the full list of Contributors is available here: http://msnoise.org/doc/contributors.html.

History

  • 2010: MSNoise is based on Matlab, c++, csh and fortran codes developped at ISTerre/Univ. Grenoble and IPGP in the framework of the ERC Whisper project.
  • 2011/12: MSNoise is tested on Undervolc data, and used by Corentin for his PhD thesis.
  • 2013: First release of MSNoise for the IAVCEI 2013 in Kagoshima (Release Notes).
  • 2014: Improvements and bugfixes, release 1.2.5. Publication of the SRL article (Release Notes).
  • 2015: MSNoise 1.3: MSNoise is real python package, with a documented API and new plots (Release Notes).
  • 2016: MSNoise 1.4: new web admin interface, plugin support, instrument response removal and phase weighted stacking (Release Notes).
  • 2017: MSNoise 1.5: Autocorrelation / Single Station correlation support, rewritten preprocessing, new_jobs and scan_archive for more performance, better instrument response preloading (Release Notes).
  • 2019: MSNoise 1.6: Optimisation of the workflow (one job type per step), HPC support, faster compute_cc step, PSD-whitening, DB optimisations (Release Notes)
  • 2024: MSNoise 2.0: Massive optimisation of all steps (xarray-based), sub-daily dv/v computation, PSD QC calculation, ... Already available if you install the "dev" version (could be unstable!).

Documentation

The full documentation can be found on: http://www.msnoise.org/doc. The documentation of the master branch (active development): http://www.msnoise.org/doc/master

Installation

Please follow the instructions in the documentation: http://msnoise.org/doc/installation.html

Remember, always consider the current GitHub master as not stable!

Getting Help

✨ Please make use of the https://github.com/ROBelgium/MSNoise/discussions the GitHub Discussions for questions !✨

--

You can also search the mailing list's archive on http://mailman-as.oma.be/pipermail/msnoise/ or https://www.mail-archive.com/msnoise@mailman-as.oma.be/.

Citing MSNoise

If you use MSNoise, even a small part of it, for your research and publications, please consider citing it:

Lecocq, T., C. Caudron, et F. Brenguier (2014), MSNoise, a Python Package for Monitoring Seismic Velocity Changes Using Ambient Seismic Noise, Seismological Research Letters, 85(3), 715‑726, doi:10.1785/0220130073.

Thanks to all who already did so!

Disclaimer

Although we have cross-checked the whole code, we cannot warranty it is exempt of bugs. The package is provided as-is, we will not be held responsible for any use you make of it, nor for the results and conclusions you may find using MSNoise.

Licence

MSNoise is released under EUPL v1.1