Skip to content
Switch branches/tags
Go to file


Failed to load latest commit information.
Latest commit message
Commit time


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

CI Builds: Build Status Build 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:


  • 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)


The full documentation can be found on:


Please follow the instructions in the documentation:

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

Getting Help

The best way to get help is to subscribe to the Mailing List and ask your question directly there. It is available on and the archive is or

Join us on the Gitter Chat: Join the chat at

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!


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.


MSNoise is released under EUPL v1.1