Articles | Volume 15, issue 16
https://doi.org/10.5194/gmd-15-6359-2022
© Author(s) 2022. This work is distributed under
the Creative Commons Attribution 4.0 License.
the Creative Commons Attribution 4.0 License.
https://doi.org/10.5194/gmd-15-6359-2022
© Author(s) 2022. This work is distributed under
the Creative Commons Attribution 4.0 License.
the Creative Commons Attribution 4.0 License.
Modular Assessment of Rainfall–Runoff Models Toolbox (MARRMoT) v2.1: an object-oriented implementation of 47 established hydrological models for improved speed and readability
Department of Infrastructure Engineering, University of Melbourne, Melbourne, Parkville VIC 3052, Australia
Wouter J. M. Knoben
Centre for Hydrology, University of Saskatchewan, Canmore, Alberta T1W 3G1, Canada
Keirnan J. A. Fowler
Department of Infrastructure Engineering, University of Melbourne, Melbourne, Parkville VIC 3052, Australia
Margarita Saft
Department of Infrastructure Engineering, University of Melbourne, Melbourne, Parkville VIC 3052, Australia
Murray C. Peel
Department of Infrastructure Engineering, University of Melbourne, Melbourne, Parkville VIC 3052, Australia
Related authors
Keirnan Fowler, Murray Peel, Margarita Saft, Tim J. Peterson, Andrew Western, Lawrence Band, Cuan Petheram, Sandra Dharmadi, Kim Seong Tan, Lu Zhang, Patrick Lane, Anthony Kiem, Lucy Marshall, Anne Griebel, Belinda E. Medlyn, Dongryeol Ryu, Giancarlo Bonotto, Conrad Wasko, Anna Ukkola, Clare Stephens, Andrew Frost, Hansini Gardiya Weligamage, Patricia Saco, Hongxing Zheng, Francis Chiew, Edoardo Daly, Glen Walker, R. Willem Vervoort, Justin Hughes, Luca Trotter, Brad Neal, Ian Cartwright, and Rory Nathan
Hydrol. Earth Syst. Sci., 26, 6073–6120, https://doi.org/10.5194/hess-26-6073-2022, https://doi.org/10.5194/hess-26-6073-2022, 2022
Short summary
Short summary
Recently, we have seen multi-year droughts tending to cause shifts in the relationship between rainfall and streamflow. In shifted catchments that have not recovered, an average rainfall year produces less streamflow today than it did pre-drought. We take a multi-disciplinary approach to understand why these shifts occur, focusing on Australia's over-10-year Millennium Drought. We evaluate multiple hypotheses against evidence, with particular focus on the key role of groundwater processes.
Keirnan J. A. Fowler, Ziqi Zhang, and Xue Hou
Earth Syst. Sci. Data, 17, 4079–4095, https://doi.org/10.5194/essd-17-4079-2025, https://doi.org/10.5194/essd-17-4079-2025, 2025
Short summary
Short summary
This paper presents version 2 of the Australian edition of the Catchment Attributes and Meteorology for Large-sample Studies (CAMELS) series of datasets. CAMELS-AUS (Australia) v2 comprises data for an increased number (561) of catchments, each with long-term monitoring, combining hydrometeorological time series with attributes related to geology, soil, topography, land cover, anthropogenic influence and hydroclimatology. It is freely downloadable from https://zenodo.org/doi/10.5281/zenodo.12575680.
Gabrielle Burns, Keirnan Fowler, Murray Peel, and Clare Stephens
EGUsphere, https://doi.org/10.5194/egusphere-2025-3122, https://doi.org/10.5194/egusphere-2025-3122, 2025
This preprint is open for discussion and under review for Hydrology and Earth System Sciences (HESS).
Short summary
Short summary
Improving how rainfall-runoff models estimate evapotranspiration is key to better reproducing water partitioning under current conditions, and will increase model realism under future changing conditions. We tested how well different conceptual rainfall-runoff model equations simulate evapotranspiration using Australian catchment and flux tower data. We found one equation consistently worked better than the others. However, even this equation had flaws, pointing to missing vegetation processes.
Hansini Gardiya Weligamage, Keirnan Fowler, Margarita Saft, Tim Peterson, Dongryeol Ryu, and Murray Peel
EGUsphere, https://doi.org/10.5194/egusphere-2025-3373, https://doi.org/10.5194/egusphere-2025-3373, 2025
This preprint is open for discussion and under review for Hydrology and Earth System Sciences (HESS).
Short summary
Short summary
This study adopts actual evapotranspiration (AET) signatures to diagnose deficiencies in simulation of AET within conceptual rainfall-runoff models. Five models are assessed using flux tower data at 14 Australian sites. Even when AET is included in the calibration, the models struggle to represent aspects of AET dynamics, including interannual variability and timing on seasonal and event scales. The approach shows promise for more insightful critique of model simulations.
Wouter J. M. Knoben, Ashwin Raman, Gaby J. Gründemann, Mukesh Kumar, Alain Pietroniro, Chaopeng Shen, Yalan Song, Cyril Thébault, Katie van Werkhoven, Andrew W. Wood, and Martyn P. Clark
Hydrol. Earth Syst. Sci., 29, 2361–2375, https://doi.org/10.5194/hess-29-2361-2025, https://doi.org/10.5194/hess-29-2361-2025, 2025
Short summary
Short summary
Hydrologic models are needed to provide simulations of water availability, floods, and droughts. The accuracy of these simulations is often quantified with so-called performance scores. A common thought is that different models are more or less applicable to different landscapes, depending on how the model works. We show that performance scores are not helpful in distinguishing between different models and thus cannot easily be used to select an appropriate model for a specific place.
Sandra Pool, Keirnan Fowler, Hansini Gardiya Weligamage, and Murray Peel
EGUsphere, https://doi.org/10.5194/egusphere-2025-1598, https://doi.org/10.5194/egusphere-2025-1598, 2025
Short summary
Short summary
Multivariate calibration has become a widely used method to improve model realism. We found that multivariate calibration can lead to less constrained flux maps and more uncertain hydrographs relative to univariate calibration. These symptoms could be caused by non-overlapping behavioural parameter distributions for the individual calibration variables. The results emphasize that the value of non-discharge data in calibration is contingent on the suitability of the model structure.
Wouter J. M. Knoben, Kasra Keshavarz, Laura Torres-Rojas, Cyril Thébault, Nathaniel W. Chaney, Alain Pietroniro, and Martyn P. Clark
EGUsphere, https://doi.org/10.5194/egusphere-2025-893, https://doi.org/10.5194/egusphere-2025-893, 2025
Short summary
Short summary
Many existing data sets for hydrologic analysis tend treat catchments as single, spatially homogeneous units, focus on daily data and typically do not support more complex models. This paper introduces a data set that goes beyond this setup by: (1) providing data at higher spatial and temporal resolution, (2) specifically considering the data requirements of all common hydrologic model types, (3) using statistical summaries of the data aimed at quantifying spatial and temporal heterogeneity.
Matthew O. Grant, Anna M. Ukkola, Elisabeth Vogel, Sanaa Hobeichi, Andy J. Pitman, Alex Raymond Borowiak, and Keirnan Fowler
EGUsphere, https://doi.org/10.5194/egusphere-2024-4024, https://doi.org/10.5194/egusphere-2024-4024, 2025
Short summary
Short summary
Australia is regularly subjected to severe and widespread drought. By using multiple drought indicators, we show that while there have been widespread decreases in droughts since the beginning of the 20th century. However, many regions have seen an increase in droughts in more recent decades. Despite these changes, our analysis shows that they remain within the range of observed variability and are not unprecedented in the context of past droughts.
Hansini Gardiya Weligamage, Keirnan Fowler, Margarita Saft, Tim Peterson, Dongryeol Ryu, and Murray Peel
Hydrol. Earth Syst. Sci. Discuss., https://doi.org/10.5194/hess-2024-373, https://doi.org/10.5194/hess-2024-373, 2025
Preprint under review for HESS
Short summary
Short summary
This study is the first to propose actual evapotranspiration (AET) signatures, which can be used to assess multiple aspects of AET dynamics across various temporal scales. As a demonstration, we applied AET signatures to evaluate two remotely sensed (RS) AET products against flux tower AET. The results reveal specific deficiencies in RS AET and provide guidance for selecting appropriate RS AET, including for modelling studies.
Louise Arnal, Martyn P. Clark, Alain Pietroniro, Vincent Vionnet, David R. Casson, Paul H. Whitfield, Vincent Fortin, Andrew W. Wood, Wouter J. M. Knoben, Brandi W. Newton, and Colleen Walford
Hydrol. Earth Syst. Sci., 28, 4127–4155, https://doi.org/10.5194/hess-28-4127-2024, https://doi.org/10.5194/hess-28-4127-2024, 2024
Short summary
Short summary
Forecasting river flow months in advance is crucial for water sectors and society. In North America, snowmelt is a key driver of flow. This study presents a statistical workflow using snow data to forecast flow months ahead in North American snow-fed rivers. Variations in the river flow predictability across the continent are evident, raising concerns about future predictability in a changing (snow) climate. The reproducible workflow hosted on GitHub supports collaborative and open science.
Yalan Song, Wouter J. M. Knoben, Martyn P. Clark, Dapeng Feng, Kathryn Lawson, Kamlesh Sawadekar, and Chaopeng Shen
Hydrol. Earth Syst. Sci., 28, 3051–3077, https://doi.org/10.5194/hess-28-3051-2024, https://doi.org/10.5194/hess-28-3051-2024, 2024
Short summary
Short summary
Differentiable models (DMs) integrate neural networks and physical equations for accuracy, interpretability, and knowledge discovery. We developed an adjoint-based DM for ordinary differential equations (ODEs) for hydrological modeling, reducing distorted fluxes and physical parameters from errors in models that use explicit and operation-splitting schemes. With a better numerical scheme and improved structure, the adjoint-based DM matches or surpasses long short-term memory (LSTM) performance.
Diogo Costa, Kyle Klenk, Wouter Knoben, Andrew Ireson, Raymond J. Spiteri, and Martyn Clark
EGUsphere, https://doi.org/10.5194/egusphere-2023-2787, https://doi.org/10.5194/egusphere-2023-2787, 2023
Preprint archived
Short summary
Short summary
This work helps improve water quality simulations in aquatic ecosystems through a new modeling concept, which we termed “OpenWQ”. It allows tailoring biogeochemistry calculations and integration with existing hydrological (water quantity) simulation tools. The integration is demonstrated with two hydrological models. The models were tested for different pollution scenarios. This paper helps improve interoperability, transparency, flexibility, and reproducibility in water quality simulations.
Keirnan Fowler, Murray Peel, Margarita Saft, Tim J. Peterson, Andrew Western, Lawrence Band, Cuan Petheram, Sandra Dharmadi, Kim Seong Tan, Lu Zhang, Patrick Lane, Anthony Kiem, Lucy Marshall, Anne Griebel, Belinda E. Medlyn, Dongryeol Ryu, Giancarlo Bonotto, Conrad Wasko, Anna Ukkola, Clare Stephens, Andrew Frost, Hansini Gardiya Weligamage, Patricia Saco, Hongxing Zheng, Francis Chiew, Edoardo Daly, Glen Walker, R. Willem Vervoort, Justin Hughes, Luca Trotter, Brad Neal, Ian Cartwright, and Rory Nathan
Hydrol. Earth Syst. Sci., 26, 6073–6120, https://doi.org/10.5194/hess-26-6073-2022, https://doi.org/10.5194/hess-26-6073-2022, 2022
Short summary
Short summary
Recently, we have seen multi-year droughts tending to cause shifts in the relationship between rainfall and streamflow. In shifted catchments that have not recovered, an average rainfall year produces less streamflow today than it did pre-drought. We take a multi-disciplinary approach to understand why these shifts occur, focusing on Australia's over-10-year Millennium Drought. We evaluate multiple hypotheses against evidence, with particular focus on the key role of groundwater processes.
Wouter J. M. Knoben and Diana Spieler
Hydrol. Earth Syst. Sci., 26, 3299–3314, https://doi.org/10.5194/hess-26-3299-2022, https://doi.org/10.5194/hess-26-3299-2022, 2022
Short summary
Short summary
This paper introduces educational materials that can be used to teach students about model structure uncertainty in hydrological modelling. There are many different hydrological models and differences between these models impact their usefulness in different places. Such models are often used to support decision making about water resources and to perform hydrological science, and it is thus important for students to understand that model choice matters.
Keirnan J. A. Fowler, Suwash Chandra Acharya, Nans Addor, Chihchung Chou, and Murray C. Peel
Earth Syst. Sci. Data, 13, 3847–3867, https://doi.org/10.5194/essd-13-3847-2021, https://doi.org/10.5194/essd-13-3847-2021, 2021
Short summary
Short summary
This paper presents the Australian edition of the Catchment Attributes and Meteorology for Large-sample Studies (CAMELS) series of datasets. CAMELS-AUS comprises data for 222 unregulated catchments with long-term monitoring, combining hydrometeorological time series (streamflow and 18 climatic variables) with 134 attributes related to geology, soil, topography, land cover, anthropogenic influence and hydroclimatology. It is freely downloadable from https://doi.pangaea.de/10.1594/PANGAEA.921850.
Manuela I. Brunner, Lieke A. Melsen, Andrew W. Wood, Oldrich Rakovec, Naoki Mizukami, Wouter J. M. Knoben, and Martyn P. Clark
Hydrol. Earth Syst. Sci., 25, 105–119, https://doi.org/10.5194/hess-25-105-2021, https://doi.org/10.5194/hess-25-105-2021, 2021
Short summary
Short summary
Assessments of current, local, and regional flood hazards and their future changes often involve the use of hydrologic models. A reliable model ideally reproduces both local flood characteristics and regional aspects of flooding. In this paper we investigate how such characteristics are represented by hydrologic models. Our results show that both the modeling of local and regional flood characteristics are challenging, especially under changing climate conditions.
Shervan Gharari, Martyn P. Clark, Naoki Mizukami, Wouter J. M. Knoben, Jefferson S. Wong, and Alain Pietroniro
Hydrol. Earth Syst. Sci., 24, 5953–5971, https://doi.org/10.5194/hess-24-5953-2020, https://doi.org/10.5194/hess-24-5953-2020, 2020
Short summary
Short summary
This work explores the trade-off between the accuracy of the representation of geospatial data, such as land cover, soil type, and elevation zones, in a land (surface) model and its performance in the context of modeling. We used a vector-based setup instead of the commonly used grid-based setup to identify this trade-off. We also assessed the often neglected parameter uncertainty and its impact on the land model simulations.
Cited articles
Addor, N., Newman, A. J., Mizukami, N., and Clark, M. P.: The CAMELS data set: catchment attributes and meteorology for large-sample studies, Hydrol. Earth Syst. Sci., 21, 5293–5313, https://doi.org/10.5194/hess-21-5293-2017, 2017.
Arsenault, R., Poulin, A., Côté, P., and Brissette, F.: Comparison of Stochastic Optimization Algorithms in Hydrological Model Calibration, J. Hydrol. Eng., 19, 1374–1384, https://doi.org/10.1061/(ASCE)HE.1943-5584.0000938, 2014.
Beven, K. J. and Kirkby, M. J.: A physically based, variable contributing area model of basin hydrology/Un modèle à base physique de zone d'appel variable de l'hydrologie du bassin versant, Hydrol. Sci. B., 24, 43–69, https://doi.org/10.1080/02626667909491834, 1979.
Burnash, R. J. C.: The NWS River Forecast System-catchment modeling, Computer models of watershed hydrology, Water Resources Publications, Colorado, USA, ISBN 978-0-918334-91-6, 311–366, 1995.
Clark, M. P. and Kavetski, D.: Ancient numerical daemons of conceptual hydrological modeling: 1. Fidelity and efficiency of time stepping schemes, Water Resour. Res., 46, 1–23, https://doi.org/10.1029/2009WR008894, 2010.
Clark, M. P., Kavetski, D., and Fenicia, F.: Pursuing the method of multiple working hypotheses for hydrological modeling, Water Resour. Res., 47, 1–27, https://doi.org/10.1029/2010WR009827, 2011.
Fenicia, F., Kavetski, D., and Savenije, H. H. G.: Elements of a flexible approach for conceptual hydrological modeling: 1. Motivation and theoretical development, Water Resour. Res., 47, 1–13, https://doi.org/10.1029/2010WR010174, 2011.
Gupta, H. V., Kling, H., Yilmaz, K. K., and Martinez, G. F.: Decomposition of the mean squared error and NSE performance criteria: Implications for improving hydrological modelling, J. Hydrol., 377, 80–91, https://doi.org/10.1016/j.jhydrol.2009.08.003, 2009.
Hansen, N. and Ostermeier, A.: Adapting arbitrary normal mutation distributions in evolution strategies: the covariance matrix adaptation, in: Proceedings of the IEEE Conference on Evolutionary Computation, Nagoya, Japan, 22–26 May 1996, 312–317, https://doi.org/10.1109/icec.1996.542381, 1996.
Hansen, N., Müller, S. D., and Koumoutsakos, P.: Reducing the time complexity of the derandomized evolution strategy with covariance matrix adaptation (CMA-ES), Evol. Comput., 11, 1–18, https://doi.org/10.1162/106365603321828970, 2003.
Herath, H. M. V. V., Chadalawada, J., and Babovic, V.: Hydrologically informed machine learning for rainfall–runoff modelling: towards distributed modelling, Hydrol. Earth Syst. Sci., 25, 4373–4401, https://doi.org/10.5194/hess-25-4373-2021, 2021.
Kavetski, D. and Clark, M. P.: Ancient numerical daemons of conceptual hydrological modeling: 2. Impact of time stepping schemes on model analysis and prediction, Water Resour. Res., 46, 1–28, https://doi.org/10.1029/2009WR008896, 2010.
Kavetski, D. and Kuczera, G.: Model smoothing strategies to remove microscale discontinuities and spurious secondary optima im objective functions in hydrological calibration, Water Resour. Res., 43, 1–9, https://doi.org/10.1029/2006WR005195, 2007.
Kavetski, D., Kuczera, G., and Franks, S. W.: Calibration of conceptual hydrological models revisited: 1. Overcoming numerical artefacts, J. Hydrol., 320, 173–186, https://doi.org/10.1016/j.jhydrol.2005.07.012, 2006.
Knoben, W.: wknoben/MARRMoT: MARRMoT_v1.0, Zenodo [code], https://doi.org/10.5281/zenodo.2482542, 2018.
Knoben, W.: wknoben/MARRMoT: MARRMoT_v1.1, Zenodo [code], https://doi.org/10.5281/zenodo.2677728, 2019a.
Knoben, W.: wknoben/MARRMoT: MARRMoT_v1.2, Zenodo [code], https://doi.org/10.5281/zenodo.3235664, 2019b.
Knoben, W.: wknoben/MARRMoT: MARRMoT_v1.3, Zenodo [code], https://doi.org/10.5281/zenodo.3552961, 2019c.
Knoben, W. and Trotter, L.: wknoben/MARRMoT: MARRMoT_v1.4, Zenodo [code], https://doi.org/zenodo.6460624, 2022.
Knoben, W. J. M., Freer, J. E., Fowler, K. J. A., Peel, M. C., and Woods, R. A.: 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, Geosci. Model Dev., 12, 2463–2480, https://doi.org/10.5194/gmd-12-2463-2019, 2019.
Knoben, W. J. M., Freer, J. E., Peel, M. C., Fowler, K. J. A., and Woods, R. A.: A Brief Analysis of Conceptual Model Structure Uncertainty Using 36 Models and 559 Catchments, Water Resour. Res., 56, 1–23, https://doi.org/10.1029/2019WR025975, 2020.
Liang, X., Lettenmaier, D. P., Wood, E. F., and Burges, S. J.: A simple hydrologically based model of land surface water and energy fluxes for general circulation models, J. Geophys. Res.-Atmos., 99, 14415–14428, https://doi.org/10.1029/94JD00483, 1994.
Lindström, G., Johansson, B., Persson, M., Gardelin, M., and Bergström, S.: Development and test of the distributed HBV-96 hydrological model, J. Hydrol., https://doi.org/10.1016/S0022-1694(97)00041-3, 201, 272–288, 1997.
Nash, J. E. and Sutcliffe, J. V.: River flow forecasting through conceptual models part I – A discussion of principles, J. Hydrol., 10, 282–290, https://doi.org/10.1016/0022-1694(70)90255-6, 1970.
Peel, M. C. and McMahon, T. A.: Historical Development of Rainfall-Runoff Modelling, WIRES Water, 7, 1–15, https://doi.org/10.1002/wat2.1471, 2020.
Perrin, C., Michel, C., and Andréassian, V.: Improvement of a parsimonious model for streamflow simulation, J. Hydrol., 279, 275–289, https://doi.org/10.1016/S0022-1694(03)00225-7, 2003.
Stefik, M. and Bobrow, D. G.: Object-Oriented Programming: Themes and Variations, AI Mag., 6, 40–62, 1985.
Trotter, L. and Knoben, W.: MARRMoT v2.0, Zenodo [code], https://doi.org/10.5281/zenodo.6483914, 2022a.
Trotter, L. and Knoben, W.: MARRMoT v2.1, Zenodo [code], https://doi.org/10.5281/zenodo.6484372, 2022b.
Westra, S., Thyer, M., Leonard, M., Kavetski, D., and Lambert, M.: A strategy for diagnosing and interpreting hydrological model nonstationarity, Water Resour. Res., 50, 5090–5113, https://doi.org/10.1002/2013WR014719, 2014.
Short summary
MARRMoT is a piece of software that emulates 47 common models for hydrological simulations. It can be used to run and calibrate these models within a common environment as well as to easily modify them. We restructured and recoded MARRMoT in order to make the models run faster and to simplify their use, while also providing some new features. This new MARRMoT version runs models on average 3.6 times faster while maintaining very strong consistency in their outputs to the previous version.
MARRMoT is a piece of software that emulates 47 common models for hydrological simulations. It...