Submitted as: model description paper 16 Dec 2020

Submitted as: model description paper | 16 Dec 2020

Review status: this preprint is currently under review for the journal GMD.

SuperflexPy 1.2.0: an open source Python framework for building, testing and improving conceptual hydrological models

Marco Dal Molin1,2, Dmitri Kavetski1,3, and Fabrizio Fenicia1 Marco Dal Molin et al.
  • 1Eawag, Swiss Federal Institute of Aquatic Science and Technology, Dübendorf, Switzerland
  • 2The Centre of Hydrogeology and Geothermics (CHYN), University of Neuchâtel, Neuchâtel, Switzerland
  • 3School of Civil, Environmental and Mining Engineering, University of Adelaide, SA, Australia

Abstract. Catchment-scale hydrological models are widely used to represent and improve our understanding of hydrological processes, and to support operational water resources management. Conceptual models, where catchment dynamics are approximated using relatively simple storage and routing elements, offer an attractive compromise in terms of predictive accuracy, computational demands and amenability to interpretation. This paper introduces SuperflexPy, an open-source Python framework implementing the SUPERFLEX principles (Fenicia et al., 2011) for building conceptual hydrological models from generic components, with a high degree of control over all aspects of model specification. SuperflexPy can be used to build models of a wide range of spatial complexity, ranging from simple lumped models (e.g. a reservoir) to spatially distributed configurations (e.g. nested sub-catchments), with the ability to customize all individual model elements. SuperflexPy is a Python package, enabling modelers to exploit the full potential of the framework without the need for separate software installations, and making it easier to use and interface with existing Python code for model deployment. This paper presents the general architecture of SuperflexPy, and illustrates its usage to build conceptual models of varying degrees of complexity. The illustration includes the usage of existing SuperflexPy model elements, as well as their extension to implement new functionality. SuperflexPy is available as open-source code, and can be used by the hydrological community to investigate improved process representations, for model comparison, and for operational work. A comprehensive documentation is available online and provided as supplementary material to this paper.

Marco Dal Molin et al.

Status: open (until 10 Feb 2021)
Status: open (until 10 Feb 2021)
AC: Author comment | RC: Referee comment | SC: Short comment | EC: Editor comment
[Subscribe to comment alert] Printer-friendly Version - Printer-friendly version Supplement - Supplement

Marco Dal Molin et al.

Model code and software

SuperflexPy, v.1.2.0 Marco Dal Molin, Dmitri Kavetski, and Fabrizio Fenicia

Marco Dal Molin et al.


Total article views: 307 (including HTML, PDF, and XML)
HTML PDF XML Total Supplement BibTeX EndNote
215 88 4 307 40 3 2
  • HTML: 215
  • PDF: 88
  • XML: 4
  • Total: 307
  • Supplement: 40
  • BibTeX: 3
  • EndNote: 2
Views and downloads (calculated since 16 Dec 2020)
Cumulative views and downloads (calculated since 16 Dec 2020)

Viewed (geographical distribution)

Total article views: 285 (including HTML, PDF, and XML) Thereof 279 with geography defined and 6 with unknown origin.
Country # Views %
  • 1
Latest update: 22 Jan 2021