Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

PyALTIWAVES: Python-based ALong-Track Inventory of WAVelet based EddieS

Project description

PyALTIWAVES - Python-based ALong-Track Inventory of WAVelet based EddieS

--> Automatic census of eddies from along-track altimetry data.

This library has been base on the work of Dussurget et al., 2011 in the Bay of Biscay and updated with the work accomplished in the Golf of Mexico by Le Hénaff et al, 2012.
Wavelet analysis is applied along-track to detect gaussian-shaped signals such as Oceanic Eddies. Once detected, their properties can thus be derived over a given area or period. Properties include several definitions of the spatial length-scales (eg. decorrelation scale and size of the core of a solid-body rotating eddy), amplitude, rotation sense, relative vorticity, etc.

Useful references:
* Dussurget, R., F. Birol, et R.A. Morrow. in prep. « Constructing fine-scale multi-mission altimeter maps for regional and coastal applications »

* Le Henaff, M., V. H. Kourafalou, R. Dussurget, R. Lumpkin. 2013. « Cyclonic activity in the eastern Gulf of Mexico: characterization from along-track altimetry and in situ drifter trajectories ». Progress in Oceanography, Available online 14 September 2013, ISSN 0079-6611, (

* Dussurget, R, F Birol, R.A. Morrow, et P. De Mey. 2011. « Fine Resolution Altimetry Data for a Regional Application in the Bay of Biscay ». Marine Geodesy 2 (34): 1‑30. doi:10.1080/01490419.2011.584835.

* Lilly, J.M., P.B. Rhines, F. Schott, K. Lavender, J. Lazier, U. Send, et E. D’Asaro. 2003. « Observations of the Labrador Sea eddy field ». Progress In Oceanography 59 (1) (octobre): 75‑176. doi:10.1016/j.pocean.2003.08.013.

* Torrence, C., et G.P. Compo. 1998. « A Practical Guide to Wavelet Analysis ». Bulletin of the American Meteorological Society 79 (1) (janvier 1): 61‑78.

Installation :
Refer to the `Download <>`_ page.

Special notes:

Author :
Renaud DUSSURGET, renaud.dussurget

Licensing & copyright:
`GNU Lesser General Public License <>`. Copyright 2012 Renaud Dussurget::

PyAltiWAVES is free software: you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option)
any later version.
PyAltiWAVES is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
for more details.

You should have received a copy of the GNU Lesser General Public License along
with PyAltiWAVES. If not, see <>.

History :
* Adapted from CTOH/LEGOS IDL ALTI_WAVES library (RD).
* November 2012 : Converted to Python
- Added computation of eddy core scale and relative vorticity
- Improved 2D eddy detection
- Modified decorrelation scales (asses the scale on both sides of eddy) : still require some work when computing the scales.
- Added computing temporal variability of parameters.
- Added a test case using simulated red noise data.
- Tested on DUACS MERSEA NRT & DT products over Med : spatial and temporal variability of eddy properties.
- Validation over GoM : good agreement over long time series, improved consistency.
* February 2013 :
- Adapted to 20Hz altimetry data analysis
- Added spectral analysis functions (compute mean spectrum and perdiodogram).
- Added rankine eddy fitting to data : better estimation of relative vorticity.
* March 2016:
- Transferred to github and integration of minor corrections/evolutions

Project details

Release history Release notifications

This version
History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
py-altiwaves-0.2.0.post1.linux-x86_64.tar.gz (57.1 kB) Copy SHA256 hash SHA256 Dumb Binary any Mar 24, 2016
py_altiwaves-0.2.0.post1-py2-none-any.whl (43.7 kB) Copy SHA256 hash SHA256 Wheel 2.7 Mar 24, 2016
py-altiwaves-0.2.0.post1.tar.gz (31.0 kB) Copy SHA256 hash SHA256 Source None Mar 24, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page