trichter / pygtide

A Python module and wrapper for ETERNA PREDICT to compute gravitational tides on Earth

PyGTide

A Python module and wrapper for ETERNA PREDICT to compute gravitational tides on Earth

PyGTide is a Python class that wraps around ETERNA PREDICT 3.4 which was compiled from Fortran into a Python DLL using f2py. The original ETERNA PREDICT 3.3 was written by the late Prof. H.-G. Wenzel (Wenzel, 1996) in a mix of Fortran 77 and 90. This was updated by Kudryavtsev (2004) to include the latest tidal catalogue. The Fortran code for ETERNA PREDICT can be downloaded from the International Geodynamics and Earth Tide Service (IGETS).

How to install and run

Instructions:

• Download and install Anaconda or Miniconda
• Create an environment with the packages, numpy pandas datetime requests git
• Download and install pygtide, e.g. with pip install git+https://github.com/trichter/pygtide.git
• Run tests with python -c 'import pygtide; pygtide.test(msg=True)'
• Data files can be updated with python -c 'import pygtide; pygtide.update_data_files()'
• See pygtide/tests.py for example calls, e.g.:

from pygtide import predict_series
args = (-20.82071, -70.15288, 830.0, '2020-01-01', 6, 600)
series = predict_series(*args, statazimut=90, tidalcompo=8)

How to cite

If you use PyGTide, please cite the work as:

Rau, Gabriel C. (2018) hydrogeoscience/pygtide: PyGTid. Zenodo. https://zenodo.org/record/4290320

(original repository)

Example

This image shows Earth tides calculated for the city Karlsruhe (Germany) in the year 2018.

References

• Hartmann, T., and H.-G. Wenzel (1995), The HW95 tidal potential catalogue, Geophysical Research Letters, 22(24), 3553–3556, https://doi.org/10.1029/95GL03324.
• Kudryavtsev, S. M. (2004), Improved harmonic development of the Earth tide-generating potential, Journal of Geodesy, 17(12), 829-838, https://doi.org/10.1007/s00190-003-0361-2.
• Wenzel, H.-G. (1996), The nanogal software: Earth tide data processing package ETERNA 3.30, Bulletin d’Informations des Marées Terrestres, 124, 9425–9439.
• McMillan, T. C., and Rau, G. C., and Timms, W. A., and Andersen, M. S. (2019), Utilizing the impact of Earth and atmospheric tides on groundwater systems: A review reveals the future potential, Reviews of Geophysics, https://dx.doi.org/10.1029/2018RG000630.

License

PyGTide is released by Gabriel C. Rau under the Mozilla Public License 2.0