MSNoise - Documentation
MSNoise is a Python package for monitoring seismic velocity changes using ambient seismic noise. It automates the full pipeline from raw seismic archives to dv/v curves: cross-correlations, stacking, reference computation, and relative velocity estimation via MWCS, stretching, or wavelet methods.
MSNoise 2.x is a full rewrite built on xarray, with a config-set / lineage architecture that makes it easy to run the same data through multiple parameter branches without reprocessing from scratch. Plugins can extend or replace any step.
If you use MSNoise for your research, please cite:
Install MSNoise and learn the 2.x concepts — config sets, lineages, and jobs — before running anything.
Workflows
Step-by-step guides from project initialisation to dv/v and PSD outputs, with the exact commands at each stage.
Using MSNoise
- Reading outputs with MSNoiseResult
- How To’s - Recipes
- Run MSNoise only to have Power Spectral Densities and Spectrograms:
- Run the simplest MSNoise run ever
- Run the full workflow automatically
- Run MSNoise using lots of cores on a HPC
- Reprocess data
- Define one’s own data structure of the waveform archive
- How to have MSNoise work with 2+ data structures at the same time
- How to duplicate/dump the MSNoise configuration
- Check if my response file works
- Testing the Dependencies
- Interaction Examples & Gallery
How to read and work with computed results in notebooks and scripts, plus recipes for common tasks and a gallery of worked examples.
Full reference for the Python API, internal modules, database schema, and the plugin system.
CLI Reference
Every msnoise command, its arguments, and options.