# FullSWOF: Full Shallow-Water equations for Overland Flow

Olivier Delestre, Frédéric Darboux, Francois James, Carine Lucas, Christian Laguerre, Stéphane Cordier

► To cite this version:

Olivier Delestre, Frédéric Darboux, Francois James, Carine Lucas, Christian Laguerre, et al. FullSWOF: Full Shallow-Water equations for Overland Flow. Journal of Open Source Software, 2017, 2 (2), pp.448. 10.21105/joss.00448. hal-01668223

HAL Id: hal-01668223

https://hal.science/hal-01668223

Submitted on 19 Dec 2017

HAL is a multi-disciplinary open access
archive for the deposit and dissemination of sci-
entific research documents, whether they are pub-
lished or not. The documents may come from
teaching and research institutions in France or
abroad, or from public or private research centers.

L'archive ouverte pluridisciplinaire HAL, est
destinée au dépôt et à la diffusion de documents
scientifiques de niveau recherche, publiés ou non,
émanant des établissements d'enseignement et de
recherche français ou étrangers, des laboratoires
publics ou privés.

<figure><img src="image_1.png" /></figure>

Distributed under a Creative Commons Attribution 4.0 International License
# FullSWOF: Full Shallow-Water equations for Overland Flow

Olivier Delestre¹, Frédéric Darboux², François James³, Carine Lucas³, Christian Laguerre³, and Stéphane Cordier³

1 Lab. J.A. Dieudonné & EPU Nice Sophia, Univ. Nice, France 2 Inra, UMR 1120, Laboratoire Sols et Environnement, Nancy, France 3 MAPMO, UMR CNRS 7349, Fédération Denis Poisson, FR CNRS 2964, Université d'Orléans, F-45067 Orléans cedex 02, France.}

DOI: 10.21105/joss.00448

## Software

* Review 👅

* Repository 👅

* Archive 👅

Submitted: 24 October 2017

Published: 07 December 2017

## Licence

Authors of JOSS papers retain copyright and release the work under a Creative Commons Attribution 4.0 International License (CC-BY).

## Summary

Numerical simulations of shallow flows are required in numerous applications and are typically performed by solving shallow-water equations. FullSWOF solves these equations by using up-to-date finite volume methods and well-balanced schemes. Several features make FullSWOF particularly suitable for surface water hydrologists: small water depths and wet-dry transitions are robustly addressed, rainfall and infiltration are incorporated, and grid-based digital topographies can be used directly. The modular structure of FullSWOF is also useful to numerical modelers willing to test new schemes or boundary conditions.

A detailed mathematical description is given (Delestre et al. 2014) and the capabilities of FullSWOF are tested against analytic solutions (Delestre et al. 2013). Depending on the scenario to be simulated, both a 1D version (FullSWOF_1D) and 2D version (FullSWOF_2D) are available.

FullSWOF is mainly developed in C++. It is freely available, easy to use, and open for further development. Manuals, as well as variable names and comments, are written in English. Reproducibility of the computation is ensured by benchmarking scripts.

The codes and manuals are hosted on a web-based forge, making convenient to share code and to interact with users and developers (https://sourcesup.renater.fr/projects/fullswof-1d/ for FullSWOF_1D; https://sourcesup.renater.fr/projects/fullswof-2d/ for FullSWOF_2D). A basic graphic user interface (FullSWOFatk), written in Java, is also available (https://sourcesup.renater.fr/projects/fullswof-atk/). A generic webpage (http://www.univ-orleans.fr/mapmo/soft/FullSWOF/) summarizes the recent developments, case studies and citations.

## References

Delestre, Olivier, Frédéric Darboux, François James, Carine Lucas, Christian Laguerre, and Stephane Cordier. 2014. “FullSWOF: A free software package for the simulation of shallow water flows.” http://hal.archives-ouvertes.fr/hal-00932234.

Delestre, Olivier, Carine Lucas, Pierre-Antoine Ksinant, Frédéric Darboux, Christian Laguerre, Thi Ngoc Tuoi Vo, François James, and Stéphane Cordier. 2013. “SWASHES: A Compilation of Shallow Water Analytic Solutions for Hydraulic and Environmental Studies.” *International Journal for Numerical Methods in Fluids* 72 (3): 269–300. doi:10.1002/fld.3741.