https://github.com/petermakus/seismic

SeisMIC is a python software suite to monitor phase velocity changes in time and space in seismology using ambient noise.

https://github.com/petermakus/seismic

Science Score: 39.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 5 DOI reference(s) in README
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (17.5%) to scientific vocabulary

Keywords

environmental-seismology greens-function inversion noise noise-monitoring python research seismic seismic-noise seismology time-series

Keywords from Contributors

interactive projection sequences genomics observability autograding hacking shellcodes archival modular
Last synced: 6 months ago · JSON representation

Repository

SeisMIC is a python software suite to monitor phase velocity changes in time and space in seismology using ambient noise.

Basic Info
Statistics
  • Stars: 70
  • Watchers: 4
  • Forks: 17
  • Open Issues: 6
  • Releases: 5
Topics
environmental-seismology greens-function inversion noise noise-monitoring python research seismic seismic-noise seismology time-series
Created over 4 years ago · Last pushed 6 months ago
Metadata Files
Readme Contributing License

README.md

SeisMIC logo

Build Status Documentation Status License: EUPL v1.2 codecov DOI PyPI Python 3.11

Monitoring Velocity Changes using Ambient Seismic Noise

SeisMIC (Seismological Monitoring using Interferometric Concepts) is a python software that emerged from the miic library. SeisMIC provides functionality to apply some concepts of seismic interferometry to different data of elastic waves. Its main use case is the monitoring of temporal changes in a mediums Green's Function (i.e., monitoring of temporal velocity changes).

A velocity change time series

SeisMIC will handle the whole workflow to create velocity-change time-series including: + Downloading raw data + Adaptable preprocessing of the waveform data + Computating cross- and/or autocorrelations + Plotting tools for correlations + Database management of ambient seismic noise correlations + Adaptable postprocessing of correlations + Computation of velocity change (dv/v) time series + Postprocessing of dv/v time series + Plotting of dv/v time-series + Inverting dv/v onto a spatial grid

SeisMIC handles correlations and data in an ObsPy-like manner.

Installation of this package

Installation from PyPi (pip install)

SeisMIC is now deployed on PyPi and can simply be installed using:

```bash

We recommend installing mpi4py from the conda-forge channel instead of PyPi

conda install -c conda-forge mpi4py

pip install seismic

If you want to execute the tutorials, you will have to install jupyter as well

pip install jupyter ```

Installation from Source Code

To obtain the lates features, you can install SeisMIC from its source code, available on GitHub.

Developers should download the dev branch

Download this package via GitHub and install it via bash terminal (the few steps shown below) or using the graphical user interface

```bash

Download via wget or web-browser

wget https://github.com/PeterMakus/SeisMIC/archive/refs/heads/main.zip

For developers download the dev branch

wget https://github.com/PeterMakus/SeisMIC/archive/refs/heads/dev.zip

unzip the package

unzip main.zip # or dev.zip

Change directory to the same directory that this repo is in (i.e., same directory as setup.py)

cd SeisMIC-main # That's the standard name the folder should have

Create the conda environment and install dependencies

conda install -c conda-forge mpi4py conda env create -f environment.yml

Activate the conda environment

conda activate seismic

Install the package in editable mode

pip install -e .

If you want to execute the tutorials, you will have to install jupyter as well

pip install jupyter ```

Getting started

Access SeisMIC's documentation here.

SeisMIC comes with a few tutorials (Jupyter notebooks). You can find those in the examples/ directory.

Acknowledging the Use of SeisMIC in your Work

If you should use SeisMIC to create published scientific content please cite the SeisMIC paper: Makus, P., & Sens-Schönfelder, C. (2024). SeisMIC-an Open Source Python Toolset to Compute Velocity Changes from Ambient Seismic Noise..

Reporting Bugs / Contact the developers

This version is an early release. If you encounter any issues or unexpected behaviour, please open an issue here on GitHub.

Questions?

If you have any questions that do not require any changes in the source code, please use the discussions feature

Contributing

Thank you for contributing to SeisMIC! Have a look at our guidelines for contributors

Owner

  • Name: Peter Makus
  • Login: PeterMakus
  • Kind: user
  • Location: Potsdam
  • Company: GFZ Potsdam

Seismology PhD student at GFZ Potsdam

GitHub Events

Total
  • Create event: 3
  • Release event: 1
  • Issues event: 23
  • Watch event: 17
  • Member event: 1
  • Issue comment event: 35
  • Push event: 55
  • Pull request event: 7
  • Fork event: 5
Last Year
  • Create event: 3
  • Release event: 1
  • Issues event: 23
  • Watch event: 17
  • Member event: 1
  • Issue comment event: 35
  • Push event: 55
  • Pull request event: 7
  • Fork event: 5

Committers

Last synced: about 2 years ago

All Time
  • Total Commits: 765
  • Total Committers: 5
  • Avg Commits per committer: 153.0
  • Development Distribution Score (DDS): 0.28
Past Year
  • Commits: 193
  • Committers: 2
  • Avg Commits per committer: 96.5
  • Development Distribution Score (DDS): 0.036
Top Committers
Name Email Commits
Peter Makus m****s@g****e 551
PeterMakus p****s@g****e 193
Christoph Sens-Schönfelder c****s@g****e 15
Peter Makus 4****s 4
dependabot[bot] 4****] 2
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 27
  • Total pull requests: 61
  • Average time to close issues: 19 days
  • Average time to close pull requests: 1 day
  • Total issue authors: 10
  • Total pull request authors: 3
  • Average comments per issue: 3.11
  • Average comments per pull request: 0.33
  • Merged pull requests: 56
  • Bot issues: 0
  • Bot pull requests: 6
Past Year
  • Issues: 17
  • Pull requests: 6
  • Average time to close issues: 17 days
  • Average time to close pull requests: about 6 hours
  • Issue authors: 7
  • Pull request authors: 2
  • Average comments per issue: 2.12
  • Average comments per pull request: 0.17
  • Merged pull requests: 6
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • PeterMakus (13)
  • imme-w (4)
  • jojomale (3)
  • cheshire2cat (2)
  • wgajek (1)
  • amell567 (1)
  • Yuuki-yuuki (1)
  • mcardenass (1)
  • avuan (1)
  • geothomaslee (1)
Pull Request Authors
  • PeterMakus (58)
  • dependabot[bot] (6)
  • jojomale (2)
Top Labels
Issue Labels
bug-unconfirmed (9) enhancement (6) bug-confirmed (5) documentation (2) help wanted (1) good first issue (1)
Pull Request Labels
dependencies (6)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 1,227 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 6
  • Total maintainers: 1
pypi.org: seismic

Seismological Monitoring using Interferometric Concepts

  • Versions: 6
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 1,227 Last month
Rankings
Dependent packages count: 6.6%
Stargazers count: 13.3%
Forks count: 17.3%
Average: 17.3%
Downloads: 18.8%
Dependent repos count: 30.6%
Maintainers (1)
Last synced: 6 months ago

Dependencies

environment.yml pypi
  • pydata-sphinx-theme *
  • sphinx *
  • sphinx-copybutton *
  • sphinxcontrib-mermaid *
requirements.txt pypi
  • flake8 *
  • geographiclib *
  • h5py *
  • matplotlib *
  • numpy *
  • obspy >=1.3
  • pip *
  • prov *
  • py *
  • pydata-sphinx-theme *
  • pytest *
  • pyyaml *
  • scipy *
  • sphinx-copybutton *
  • sphinxcontrib-mermaid *
  • tqdm *