Welcome to pyswashes

PyPI version Install with Anaconda Documentation Status CircleCI status AppVeyor status code coverage

pyswashes is a python library that generates analytic solutions to the Shallow Water Equations. It facilitate the obtention of the selected analytic solution in the form of a csv, Pandas dataframe, NumPy array or ASCII Grid format.

The code is hosted on GitHub.


pyswashes is available on the Python package index and anaconda.

Installation with conda

It is recommended to install it through conda, because it relies on the swashes package that cannot be installed with pip.

conda install -c lrntct pyswashes

Installation with pip

pip install pyswashes


pyswashes is an interface to the SWASHES command line tool, created by the University of Orléans, France.

SWASHES is detailed in the following article:

SWASHES: a compilation of Shallow Water Analytic Solutions for Hydraulic and Environmental Studies’, O. Delestre, C. Lucas, P.-A. Ksinant, F. Darboux, C. Laguerre, T.N.T. Vo, F. James, S. Cordier International Journal of Numerical Methods in Fluids, 2013, 72(3): 269-300. DOI: 10.1002/fld.3741 . URL: http://hal.archives-ouvertes.fr/hal-00628246

Indices and tables