Modular Assessment of Rainfall–Runoff Models Toolbox (MARRMoT) v1.2: an open-source, extendable framework providing implementations of 46 conceptual hydrologic models as continuous state-space formulations

Abstract. This paper presents the Modular Assessment of Rainfall–Runoff Models Toolbox (MARRMoT): a modular open-source toolbox containing documentation and model code based on 46 existing conceptual hydrologic models. The toolbox is developed in MATLAB and works with Octave. MARRMoT models are based solely on traceable published material and model documentation, not on already-existing computer code. Models are implemented following several good practices of model development: the definition of model equations (the mathematical model) is kept separate from the numerical methods used to solve these equations (the numerical model) to generate clean code that is easy to adjust and debug; the implicit Euler time-stepping scheme is provided as the default option to numerically approximate each model's ordinary differential equations in a more robust way than (common) explicit schemes would; threshold equations are smoothed to avoid discontinuities in the model's objective function space; and the model equations are solved simultaneously, avoiding the physically unrealistic sequential solving of fluxes. Generalized parameter ranges are provided to assist with model inter-comparison studies. In addition to this paper and its Supplement, a user manual is provided together with several workflow scripts that show basic example applications of the toolbox. The toolbox and user manual are available from https://github.com/wknoben/MARRMoT (last access: 30 May 2019; https://doi.org/10.5281/zenodo.3235664). Our main scientific objective in developing this toolbox is to facilitate the inter-comparison of conceptual hydrological model structures which are in widespread use in order to ultimately reduce the uncertainty in model structure selection.

[1]  P. E. O'Connell,et al.  River flow forecasting through conceptual models part II - The Brosna catchment at Ferbane , 1970 .

[2]  Vijay P. Singh,et al.  A toolkit for the development and application of parsimonious hydrological models. , 2002 .

[3]  C. Perrin,et al.  Does a large number of parameters enhance model performance? Comparative assessment of common catchment model structures on 429 catchments , 2001 .

[4]  Kieran M. O'Connor,et al.  Application of an empirical infiltration equation in the SMAR conceptual model , 1996 .

[5]  Keith Beven,et al.  Equifinality, data assimilation, and uncertainty estimation in mechanistic modelling of complex environmental systems using the GLUE methodology , 2001 .

[6]  D. Boyle Multicriteria Calibration of Hydrologic Models , 2013 .

[7]  Pablo A. Mendoza,et al.  The CAMELS-CL dataset: catchment attributes and meteorology for large sample studies – Chile dataset , 2018, Hydrology and Earth System Sciences.

[8]  Anthony J. Jakeman,et al.  Corrigendum to "A Catchment Moisture Deficit module for the IHACRES rainfall-runoff model" [Environ. Model. Softw. 19(1) (2004) 1-5] , 2005, Environ. Model. Softw..

[9]  E. Hansen,et al.  NUMERICAL SIMULATION OF THE RAINFALL-RUNOFF PROCESS ON A DAILY BASIS , 1973 .

[10]  J. Kirchner Getting the right answers for the right reasons: Linking measurements, analyses, and models to advance the science of hydrology , 2006 .

[11]  Dmitri Kavetski,et al.  A unified approach for process‐based hydrologic modeling: 1. Modeling concept , 2015 .

[12]  M. Sivapalan,et al.  Exploring the physical controls of regional patterns of flow duration curves – Part 2: Role of seasonality, the regime curve, and associated process controls , 2012 .

[13]  Kieran M. O'Connor,et al.  A “monster” that made the SMAR conceptual model “right for the wrong reasons” , 2010 .

[14]  George H. Leavesley,et al.  The Modular Modeling System (MMS): User's Manual , 1996 .

[15]  Dmitri Kavetski,et al.  Elements of a flexible approach for conceptual hydrological modeling: 1. Motivation and theoretical development , 2011 .

[16]  Francesca Pianosi,et al.  A Matlab toolbox for Global Sensitivity Analysis , 2015, Environ. Model. Softw..

[17]  V. Klemeš,et al.  Operational Testing of Hydrological Simulation Models , 2022 .

[18]  J. Freer,et al.  The evolution of root-zone moisture capacities after deforestation: a step towards hydrological predictions under change? , 2016 .

[19]  Philipp Kraft,et al.  CMF: A Hydrological Programming Language Extension For Integrated Catchment Models , 2011, Environ. Model. Softw..

[20]  Jim Freer,et al.  Ensemble evaluation of hydrological model hypotheses , 2010 .

[21]  Jens Christian Refsgaard,et al.  Modelling guidelinesterminology and guiding principles , 2004 .

[22]  M. Sivapalan,et al.  Process controls of water balance variability in a large semi-arid catchment: downward approach to hydrological model development , 2001 .

[23]  Andrew Binley,et al.  GLUE: 20 years on , 2014 .

[24]  Dmitri Kavetski,et al.  Pursuing the method of multiple working hypotheses for hydrological modeling , 2011 .

[25]  C. Priestley,et al.  On the Assessment of Surface Heat Flux and Evaporation Using Large-Scale Parameters , 1972 .

[26]  Murugesu Sivapalan,et al.  Modelling water balances in an Alpine catchment through exploitation of emergent properties over changing time scales , 2003 .

[27]  R. Moore,et al.  Comparison of rainfall-runoff models for flood forecasting. Part 1: Literature review of models , 2001 .

[28]  John Ewen,et al.  VALIDATION OF CATCHMENT MODELS FOR PREDICTING LAND-USE AND CLIMATE CHANGE IMPACTS. : 2. CASE STUDY FOR A MEDITERRANEAN CATCHMENT , 1996 .

[29]  Soroosh Sorooshian,et al.  A framework for development and application of hydrological models , 2001, Hydrology and Earth System Sciences.

[30]  V. Singh,et al.  Application and testing of the simple rainfall-runoff model SIMHYD , 2002 .

[31]  J. Kirchner Aggregation in environmental systems : Catchment mean 1 transit times and young water fractions under hydrologic 2 nonstationarity 3 4 , 2015 .

[32]  J. Vrugt,et al.  Corruption of accuracy and efficiency of Markov chain Monte Carlo simulation by inaccurate numerical implementation of conceptual hydrologic models , 2010 .

[33]  G. H. Leavesley,et al.  Precipitation-runoff modeling system; user's manual , 1983 .

[34]  Dmitri Kavetski,et al.  A unified approach for process‐based hydrologic modeling: 2. Model implementation and case studies , 2015 .

[35]  K. Beven Environmental Modelling , 2007 .

[36]  Y. Vinogradov,et al.  An approach to the scaling problem in hydrological modelling: the deterministic modelling hydrological system , 2011 .

[37]  Ming Ye,et al.  Towards a comprehensive assessment of model structural adequacy , 2012 .

[38]  N. McIntyre,et al.  Catchment scale hydrological modelling: a review of model types, calibration approaches and uncertainty analysis methods in the context of recent developments in technology and applications , 2011 .

[39]  T. McMahon,et al.  Estimating actual, potential, reference crop and pan evaporation using standard meteorological data: a pragmatic synthesis , 2013 .

[40]  F. Anctil,et al.  Which potential evapotranspiration input for a lumped rainfall-runoff model?. Part 2: Towards a simple and efficient potential evapotranspiration model for rainfall-runoff modelling , 2005 .

[41]  Zhao Ren-jun,et al.  The Xinanjiang model applied in China , 1992 .

[42]  M. Sugawara,et al.  Automatic calibration of the tank model / L'étalonnage automatique d'un modèle à cisterne , 1979 .

[43]  Günter Blöschl,et al.  Hydrological modelling in a changing world , 2011 .

[44]  Guillaume Thirel,et al.  Continuous state-space representation of a bucket-type rainfall-runoff model: a case study with the GR4 model using state-space GR4 (version 1.0) , 2018 .

[45]  George Kuczera,et al.  Semidistributed hydrological modeling: A “saturation path” perspective on TOPMODEL and VIC , 2003 .

[46]  J. McDonnell,et al.  Constraining dynamic TOPMODEL responses for imprecise water table information using fuzzy rule based performance measures , 2004 .

[47]  Jan Seibert,et al.  Teaching hydrological modeling with a user-friendly catchment-runoff-model software package , 2012 .

[48]  M. Clark,et al.  Ancient numerical daemons of conceptual hydrological modeling: 2. Impact of time stepping schemes on model analysis and prediction , 2010 .

[49]  Pamela S. Naden,et al.  CLASSIC: a semi-distributed rainfall-runoff modelling system , 2007 .

[50]  Anthony J. Jakeman,et al.  Performance of conceptual rainfall‐runoff models in low‐yielding ephemeral catchments , 1997 .

[51]  Julien Lerat,et al.  Crash testing hydrological models in contrasted climate conditions: An experiment on 216 Australian catchments , 2012 .

[52]  Thibault Mathevet,et al.  Hydrology and Earth System Sciences Hess Opinions " Crash Tests for a Standardized Evaluation of Hydrological Models " , 2022 .

[53]  Demetris Koutsoyiannis,et al.  One decade of multi-objective calibration approaches in hydrological modelling: a review , 2010 .

[54]  H. Savenije “ Topography driven conceptual modelling ( FLEX-Topo ) ” , 2010 .

[55]  Dmitri Kavetski,et al.  Numerical troubles in conceptual hydrology: Approximations, absurdities and impact on hypothesis testing , 2011 .

[56]  Y. Fukushima A model of river flow forecasting for a small forested mountain catchment , 1988 .

[57]  P. Matgen,et al.  Understanding catchment behavior through stepwise model concept improvement , 2008 .

[58]  Martyn P. Clark,et al.  Framework for Understanding Structural Errors (FUSE): A modular framework to diagnose differences between hydrological models , 2008 .

[59]  Guillaume Thirel,et al.  The suite of lumped GR hydrological models in an R package , 2017, Environ. Model. Softw..

[60]  Christopher Hutton,et al.  Most computational hydrology is not reproducible, so is it really science? , 2016, Water Resources Research.

[61]  K. Beven Towards a coherent philosophy for modelling the environment , 2002, Proceedings of the Royal Society of London. Series A: Mathematical, Physical and Engineering Sciences.

[62]  A. Bárdossy,et al.  Robust estimation of hydrological model parameters , 2008 .

[63]  C. Perrin,et al.  Improvement of a parsimonious model for streamflow simulation , 2003 .

[64]  Dmitri Kavetski,et al.  Catchment properties, function, and conceptual model representation: is there a correspondence? , 2014 .

[65]  M. Sivapalan,et al.  Improving model structure and reducing parameter uncertainty in conceptual water balance models through the use of auxiliary data , 2005 .

[66]  Dmitri Kavetski,et al.  Elements of a flexible approach for conceptual hydrological modeling: 2. Application and experimental insights , 2011 .

[67]  Göran Lindström,et al.  Development and test of the distributed HBV-96 hydrological model , 1997 .

[68]  Florian Pappenberger,et al.  Impacts of uncertain river flow data on rainfall‐runoff model calibration and discharge predictions , 2010 .

[69]  George Kuczera,et al.  Calibration of conceptual hydrological models revisited: 1. Overcoming numerical artefacts , 2006 .

[70]  Anthony J. Jakeman,et al.  A catchment moisture deficit module for the IHACRES rainfall-runoff model , 2004, Environ. Model. Softw..

[71]  Hoshin Vijai Gupta,et al.  Decomposition of the mean squared error and NSE performance criteria: Implications for improving hydrological modelling , 2009 .

[72]  Lukas Gudmundsson,et al.  The Global Streamflow Indices and Metadata Archive (GSIM) – Part 2: Quality Control, Time-series Indices and Homogeneity Assessment , 2017 .

[73]  J. Seibert,et al.  Hydrological change modeling: Challenges and opportunities , 2016 .

[74]  M. Saft,et al.  The CAMELS-CL dataset : catchment attributes and meteorology for large sample studies – Chile dataset , 2018 .

[75]  George Kuczera,et al.  Model smoothing strategies to remove microscale discontinuities and spurious secondary optima in objective functions in hydrological calibration , 2007 .

[76]  Thibault Mathevet,et al.  Impact of biased and randomly corrupted inputs on the efficiency and the parameters of watershed models , 2006 .

[77]  Dmitri Kavetski,et al.  Ancient numerical daemons of conceptual hydrological modeling: 1. Fidelity and efficiency of time stepping schemes , 2010 .

[78]  Murugesu Sivapalan,et al.  Climate, soil, and vegetation controls upon the variability of water balance in temperate and semiarid landscapes: Downward approach to water balance analysis , 2003 .

[79]  Vazken Andréassian,et al.  Impact of imperfect potential evapotranspiration knowledge on the efficiency and parameters of watershed models , 2004 .

[80]  Jeffrey J. McDonnell,et al.  Threshold relations in subsurface stormflow: 2. The fill and spill hypothesis , 2006 .

[81]  Murray C. Peel,et al.  Simulating runoff under changing climatic conditions: Revisiting an apparent deficiency of conceptual rainfall‐runoff models , 2016 .

[82]  T. McMahon,et al.  Application of the daily rainfall-runoff model MODHYDROLOG to 28 Australian catchments , 1994 .

[83]  A. Rinaldo,et al.  SEHR-ECHO v1.0: a Spatially Explicit Hydrologic Response model for ecohydrologic applications , 2014 .

[84]  B. Schaefli,et al.  Earth System , 2005 .

[85]  L. Hay,et al.  PRMS-IV, the precipitation-runoff modeling system, version 4 , 2015 .

[86]  Vijay P. Singh,et al.  The NWS River Forecast System - catchment modeling. , 1995 .

[87]  A. Jayawardena,et al.  A modified spatial soil moisture storage capacity distribution curve for the Xinanjiang model , 2000 .

[88]  John Ewen,et al.  Validation of catchment models for predicting land-use and climate change impacts. 3. Blind validation for internal and outlet responses , 2004 .

[89]  Patrick M. Reed,et al.  A top-down framework for watershed model evaluation and selection under uncertainty , 2009, Environ. Model. Softw..

[90]  Pascal Côté,et al.  Comparison of Stochastic Optimization Algorithms in Hydrological Model Calibration , 2014 .

[91]  H. L. Penman THE DEPENDENCE OF TRANSPIRATION ON WEATHER AND SOIL CONDITIONS , 1950 .

[92]  Hubert H. G. Savenije,et al.  HESS Opinions "Topography driven conceptual modelling (FLEX-Topo)" , 2010 .

[93]  John Ewen,et al.  Validation of catchment models for predicting land-use and climate change impacts. 1. Method , 1996 .

[94]  Martyn P. Clark,et al.  The CAMELS data set: catchment attributes and meteorology for large-sample studies , 2017 .

[95]  Francis Chiew Hock Soon Estimating groundwater recharge using an integrated surface and groundwater model , 1990 .

[96]  Hubert H. G. Savenije,et al.  Learning from model improvement: On the contribution of complementary data to process understanding , 2008 .

[97]  Jan Seibert,et al.  Upper and lower benchmarks in hydrological modelling , 2018 .

[98]  Murugesu Sivapalan,et al.  Water and salt balance modelling to predict the effects of land‐use changes in forested catchments. 1. Small catchment water balance model , 1996 .

[99]  Nans Addor,et al.  Legacy, Rather Than Adequacy, Drives the Selection of Hydrological Models , 2019, Water Resources Research.

[100]  Peter A. Troch,et al.  The future of hydrology: An evolving science for a changing world , 2010 .

[101]  Petros Koumoutsakos,et al.  Reducing the Time Complexity of the Derandomized Evolution Strategy with Covariance Matrix Adaptation (CMA-ES) , 2003, Evolutionary Computation.

[102]  D. Lettenmaier,et al.  A simple hydrologically based model of land surface water and energy fluxes for general circulation models , 1994 .

[103]  M. Sivapalan,et al.  Climate and landscape controls on water balance model complexity over changing timescales , 2002 .

[104]  Dmitri Kavetski,et al.  The influence of conceptual model structure on model performance: a comparative study for 237 French catchments , 2013 .

[105]  V. Singh,et al.  Mathematical Modeling of Watershed Hydrology , 2002 .

[106]  G. Thirel,et al.  Looking beyond general metrics for model comparison – lessons from an international model intercomparison study , 2016 .

[107]  Murugesu Sivapalan,et al.  Dominant physical controls on hourly flow predictions and the role of spatial variability: Mahurangi catchment, New Zealand , 2003 .

[108]  J. Freer,et al.  Benchmarking observational uncertainties for hydrology: rainfall, river discharge and water quality , 2012 .

[109]  Keith Beven,et al.  A dynamic TOPMODEL , 2001 .

[110]  Lukas Gudmundsson,et al.  The Global Streamflow Indices and Metadata Archive (GSIM) – Part 1: The production of a daily streamflow archive and metadata , 2017 .

[111]  K. Loague Rainfall-Runoff Modelling , 2010 .

[112]  James W. Kirchner,et al.  Aggregation in environmental systems – part 2: catchment mean transit times and young water fractions under hydrologic nonstationarity , 2015 .