📘 Overview
In this tutorial, we will explore how to use the CAMELS (Catchment Attributes and Meteorology for Large-sample Studies) dataset to build deep learning models for rainfall–runoff prediction. You will learn how to preprocess hydrologic data, construct and train LSTM and Transformer models, and evaluate their predictive performance.
To make the tutorial lightweight and runnable on Colab (even without GPU), we’ll use a small subset (20 basins) of CAMELS that has been pre-processed and stored as a NetCDF file.
💡 The full CAMELS dataset can be downloaded and processed using the provided Python scripts (
01.download_camels.py,02.prepare_camels.py), which takes about 20 minutes.
Resources
References
Liu, J., Bian, Y., Lawson, K., & Shen, C. (2024). Probing the limit of hydrologic predictability with the Transformer network. Journal of Hydrology, 637, 131389.
Liu, J., Shen, C., O’Donncha, F., Song, Y., et al. (2025). From RNNs to Transformers: Benchmarking deep learning architectures for hydrologic prediction. EGUsphere, 2025.
Start the conversation