Skip to main content

Tidal analysis and prediction library for Python >= 3.10.x

Project description


pytides-py3 is an improved version of existing pytides to work with Python 3.10.x. The basic behavior and operation follows the original author's pytides. - Sangkon Han


Pytides is small Python package for the analysis and prediction of tides. Pytides can be used to extrapolate the tidal behaviour at a given location from its previous behaviour. The method used is that of harmonic constituents, in particular as presented by P. Schureman in Special Publication 98. The fitting of amplitudes and phases is handled by Scipy's leastsq minimisation function. Pytides currently supports the constituents used by NOAA, with plans to add more constituent sets. It is therefore possible to use the amplitudes and phases published by NOAA directly, without the need to perform the analysis again (although there may be slight discrepancies for some constituents).

It is recommended that all interactions with pytides which require times to be specified are in the format of naive UTC datetime instances. In particular, note that pytides makes no adjustment for summertime or any other civil variations within timezones.


  • Numpy
  • Scipy


easy_install pytides


pip install pytides

should do the trick.

Mainly for my own reference (sanity), to get pytides and its dependencies all working in a Debian (mint) virtualenv:

sudo apt-get install liblapack-dev libatlas-base-dev gfortran
export LAPACK=/usr/lib/
export ATLAS=/usr/lib/
export BLAS=/usr/lib/
pip install numpy
pip install scipy
pip install pytides

and you'll probably want to

pip install matplotlib

although this won't install all the backends for matplotlib, which is a headache for another day (this looks promising).


Pytides is in its infancy, and hasn't yet been fully documented. The best way to get started would be to read this example. After that, you might try making your own tide table , where you can also find a method for handling timezones. You can find information about using NOAA published Harmonic Constituents directly here .

If you want to know how Pytides works, it would be best to read P. Schureman, Special Publication 98. Alternatively, there is my attempt to explain it on the wiki (although it's a little mathematical and not yet complete). It is certainly possible to use Pytides successfully without any knowledge of its methods.


I would welcome any help with Pytides. Particularly if you have knowledge of constituent data (including node factors) which other institutions/packages use. I can be reached at or via github.

Please note however that Pytide's lack of attempts to infer constituents, or exclude similar constituents based on their synodic periods is an intentional design decision.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytides-py3-0.0.6.tar.gz (13.9 kB view hashes)

Uploaded source

Built Distribution

pytides_py3-0.0.6-py3-none-any.whl (14.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page