Package for the calculation of ellipticity corrections for teleseismic waves
Project description
EllipticiPy
A python package for the calculation of ellipticity corrections for seismic phases in elliptical planetary models.
Authors:
- Stuart Russell
- John F. Rudge
- Jessica C. E. Irving
- Sanne Cottaar
The workings of this package are described in the main paper. A preprint on Arxiv can be found at:
https://arxiv.org/abs/2205.08229
Please cite this publication when publishing work that has made use of this package.
Installation
The package can be installed using pip, the same as many python packages:
pip install ellipticipy
This package depends on ObsPy. For information regarding ObsPy please see the relevant documentation: https://docs.obspy.org/
Usage
This package is intended to be used in Python:
>>> from obspy.taup import TauPyModel
>>> from ellipticipy import ellipticity_correction
>>> model = TauPyModel('prem')
>>> arrivals = model.get_ray_paths(source_depth_in_km = 124,
distance_in_degree = 65, phase_list = ['pPKiKP'])
>>> ellipticity_correction(arrivals, azimuth = 39, source_latitude = 45)
[-0.7731978967098823]
For users that do not wish to directly interact with Python, there is a command line wrapper for calculating ellipticity corrections in src/ellip. The Python package must be installed before the wrapper can be used.
> ./ellip -d 134 -deg 64 -az 15 -sl 23 -ph P,PcP,PKiKP -mod ak135
Model: ak135
Distance Depth Phase Ray Param Spherical Ellipticity Elliptical
(deg) (km) Name p (s/deg) Travel Correction Travel
Time (s) (s) Time (s)
--------------------------------------------------------------------------------
64.00 134.0 P 6.536 619.05 -0.45 618.60
64.00 134.0 PcP 4.110 653.31 -0.48 652.83
64.00 134.0 PKiKP 1.307 1020.55 -0.75 1019.80
Examples
Further examples of code usage in Jupyter Notebook format can be found in src/. The first of these demonstrates the main usage case.
License
This package is licenced under the GNU Lesser General Public License v3.0.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ellipticipy-0.9.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d433ca0e0a64373156c9f6f8f81aaa809236d3273d40fa1f88b942a285a5a3c3 |
|
MD5 | 9fe7ebc5edc3f3f64d154e64041cbb3d |
|
BLAKE2b-256 | 32964bf012520ba8e5f8e3a8c14400b5714f430cb9eaa35a6fb7ea1913da7157 |