/mclstm_2021_mass_balance

Repository for analysis code for the 2021 paper on mass balance with LSTM/MC-LSTM

Primary LanguageJupyter Notebook

On mass conservation for predicting the long term water balance of the rainfall runoff process

Conservation of mass is a fundamental law of hydrological science. It has been proposed that conservation laws might not be benefitial to hydrological models, so long as those models can incorporate the bias between mass in (usually precipitation mass) and mass out (usually runoff mass, but also including mass loss to groundwater infiltration and evapotranspiration). We use deep learning, physics-informed deep learning,conceptual and process-based hydrology models to test the role of conservation laws in streamflow predictions. We find that both deep learning models (pure data-driven and physics-informed) have a better long term mass balance representation than the conceptual and process-based hydrology models. Explicit mass balance conservation mechanism is not required for deep learning models to achieve long term mass balance.

Results

make_run_ensembles.ipynb

This is a script that take the ensemble of model runs and combines them into a single timeseries.

calculate_mass_balance.py

This is the script to do the mass balance and subsequent mass balance error calculations.

make_tables.ipynb

This is the script to make the tables with the standard time series metrics.

make_figures.ipynb

This is the script to make the figures based on the cummulative mass balance.

supplimental_analysis_from_review2_not_for_peer_review.pdf

This is a file with some figures and some text reguarding the additional analyses for the paper revisions. The results shown in this file is not for peer review.

Data

This directory just has the CAMELS attributes and the USGS gauge information that is used in the analysis. All the forcing data are hosted on the main CAMELS website, no need for us to host them again. The model results are hosted on CUAHSI Hydroshare (link coming soon).

Figs

here are the figures.