HAL Id: hal-01668223
https://hal.archives-ouvertes.fr/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.
Distributed under a Creative Commons Attribution| 4.0 International License
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, Open
Journals, 2017, 2 (20), pp.448. �10.21105/joss.00448�. �hal-01668223�
FullSWOF: Full Shallow-Water equations for Overland
Flow
Olivier Delestre
1, Frédéric Darboux
2, François James
3, Carine Lucas
3,
Christian Laguerre
3, and Stéphane Cordier
31 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 un-der a Creative Commons Attri-bution 4.0 International License (CC-BY).
Summary
Numerical simulations of shallow flows are required in numerous applications and are typ-ically 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 (FullSWOF_UI), written in Java, is also available (https://sourcesup.renater.fr/projects/fullswof-ui/). A generic web-page (http://www.univ-orleans.fr/mapmo/soft/FullSWOF/) summarizes the recent developments, case studies and citations.
References
Delestre, Olivier, Frédéric Darboux, Francois 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.
Delestre et al., (2017). FullSWOF: Full Shallow-Water equations for Overland Flow. Journal of Open Source Software, 2(20), 448,
doi:10.21105/joss.00448