Telewavesim
Telewavesim: Python software for teleseismic body wave modeling - Published in JOSS (2019)
Science Score: 95.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 10 DOI reference(s) in README and JOSS metadata -
✓Academic publication links
Links to: joss.theoj.org, zenodo.org -
✓Committers with academic emails
1 of 3 committers (33.3%) from academic institutions -
○Institutional organization owner
-
✓JOSS paper metadata
Published in Journal of Open Source Software
Keywords
Repository
Teleseismic body wave modeling through stacks of (submarine/anisotropic) layers
Basic Info
- Host: GitHub
- Owner: paudetseis
- License: mit
- Language: Jupyter Notebook
- Default Branch: master
- Homepage: https://paudetseis.github.io/Telewavesim/
- Size: 7.74 MB
Statistics
- Stars: 76
- Watchers: 5
- Forks: 19
- Open Issues: 3
- Releases: 4
Topics
Metadata Files
README.md
Software for teleseismic body wave modeling through stacks of anisotropic layers
The structure of the Earth's crust and upper mantle gives useful information on the internal composition and dynamics of our planet. Some of the most widely used techniques to infer these properties are based on examining the effect of teleseismic body wave (i.e., P and S waves that originate from distant earthquakes and arrive as plane waves) propagation (e.g., transmission and scattering) through stratified media. Modeling the seismic response from stacks of subsurface layers is therefore an essential tool in characterizing their effect on observed seismograms.
This package contains python and fortran modules to synthesize teleseismic
body-wave propagation through stacks of generally anisotropic and strictly horizontal
layers using the matrix propagator approach of Kennett (1983), as implemented
in Thomson (1997).
The software also properly models reverberations from an overlying column of water using the R/T
matrix expressions of Bostock and Trehu (2012),
effectively simulating ocean-bottom seismic (OBS) station recordings. The software
will be useful in a variety of teleseismic receiver-based studies, such as P or S
receiver functions, long-period P-wave polarization, shear-wave splitting from
core-refracted shear waves (i.e., SKS, SKKS), etc. It may also be the starting point
for stochastic inverse methods (e.g., Monte Carlo sampling). The main part of the
code is written in fortran with python wrappers. Common computational
workflows are covered in the Jupyter notebooks bundled with this package.
<!-- 
-->
Installation, Usage, API documentation and Jupyter Notebooks are described at https://paudetseis.github.io/Telewavesim/
Citing
If you use Telewavesim in your work, please cite the Zenodo DOI
and the following paper:
- Audet, P., Thomson, C.J., Bostock, M.G., and Eulenfeld, T. (2019). Telewavesim: Python software for teleseismic body wave modeling. Journal of Open Source Software, 4(44), 1818, https://doi.org/10.21105/joss.01818
Contributing
All constructive contributions are welcome, e.g. bug reports, discussions or suggestions for new features. You can either open an issue on GitHub or make a pull request with your proposed changes. Before making a pull request, check if there is a corresponding issue opened and reference it in the pull request. If there isn't one, it is recommended to open one with your rationale for the change. New functionality or significant changes to the code that alter its behavior should come with corresponding tests and documentation. If you are new to contributing, you can open a work-in-progress pull request and have it iteratively reviewed.
Examples of straightforward contributions include adding more elastic constants or notebooks that describe published examples of teleseismic body-wave modeling. Suggestions for improvements (speed, accuracy, etc.) are also welcome.
References
Bostock, M.G., and Trehu, A.M. (2012). Wave-field decomposition of ocean-bottom seismograms. Bulletin of the Seismological Society of America, 102, 1681-1692. https://doi.org/10.1785/0120110162
Kennett, B.L.N. (1983). Seismic wave propagation in stratified media. Cambridge University Press, 342pp. https://www.oapen.org/search?identifier=459524
Thomson, C.J. (1997). Modelling surface waves in anisotropic structures: I. Theory. Physics of the Earth and Planetary interiors, 103, 195-206. https://doi.org/10.1016/S0031-9201(97)00033-2
Owner
- Name: Pascal Audet
- Login: paudetseis
- Kind: user
- Location: Ottawa, Canada
- Company: University of Ottawa
- Website: https://www.uogeophysics.com
- Repositories: 5
- Profile: https://github.com/paudetseis
Geophysicist and open source enthusiast
JOSS Publication
Telewavesim: Python software for teleseismic body wave modeling
Authors
Department of Earth and Environmental Sciences, University of Ottawa, Canada
Sherlock Seismic Solutions, Cambridge, U.K., Formerly Schlumberger Cambridge Research, U.K.
Department of Earth, Ocean and Atmospheric Sciences, The University of British Columbia, Canada
Institute of Geosciences, Friedrich Schiller University Jena, Germany
Editor
Katy Barnhart
Tags
geophysics seismology modelingGitHub Events
Total
- Issues event: 1
- Watch event: 10
- Delete event: 2
- Issue comment event: 9
- Push event: 20
- Pull request event: 6
- Fork event: 1
- Create event: 5
Last Year
- Issues event: 1
- Watch event: 10
- Delete event: 2
- Issue comment event: 9
- Push event: 20
- Pull request event: 6
- Fork event: 1
- Create event: 5
Committers
Last synced: 5 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Pascal Audet | p****t@u****a | 142 |
| trichter | t****d@u****e | 92 |
| Ben Mather | b****1@g****m | 2 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 4 months ago
All Time
- Total issues: 25
- Total pull requests: 27
- Average time to close issues: 29 days
- Average time to close pull requests: about 20 hours
- Total issue authors: 11
- Total pull request authors: 3
- Average comments per issue: 2.56
- Average comments per pull request: 1.19
- Merged pull requests: 25
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 3
- Average time to close issues: N/A
- Average time to close pull requests: 1 day
- Issue authors: 0
- Pull request authors: 1
- Average comments per issue: 0
- Average comments per pull request: 0.33
- Merged pull requests: 3
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- andreww (7)
- seisman (7)
- xichaoqiang (2)
- trichter (2)
- insersir (1)
- medlin01GA (1)
- seismoprocess (1)
- ttcat98 (1)
- Mau-dvr75 (1)
- brmather (1)
- JingHuiTong (1)
Pull Request Authors
- paudetseis (17)
- trichter (12)
- brmather (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 13 last-month
- Total dependent packages: 0
- Total dependent repositories: 1
- Total versions: 3
- Total maintainers: 2
pypi.org: telewavesim
Python package for teleseismic body-wave modeling
- Homepage: https://github.com/paudetseis/Telewavesim
- Documentation: https://telewavesim.readthedocs.io/
- License: MIT License
-
Latest release: 0.2.1
published almost 4 years ago
Rankings
Maintainers (2)
Dependencies
- matplotlib *
- numpy >=1.15
- obspy >=1.0.0
- actions/checkout v2 composite
- codecov/codecov-action v1 composite
- conda-incubator/setup-miniconda v2 composite