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:
Russell, S., Rudge, J., Irving, J. and Cottaar, S., 2022. A re-examination of ellipticity corrections for seismic phases. Geophysical Journal International, 231(3), pp.2095-2101. https://doi.org/10.1093/gji/ggac315
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-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 17eaabf2af8314ec785820cb26ea4a8d92af23739dde04656e2156c4753152d9 |
|
MD5 | 522b42efe402a4e7573aef680ae8677b |
|
BLAKE2b-256 | ec8aef8c6688a66de44985d8493fc93a746c1c48d359f9e1630f33ebd040a653 |