CAMELS Data Processing Pipeline

This repository provides an efficient pipeline to automatically download, prepare, and standardize the CAMELS hydrology dataset into an analysis-ready NetCDF format.

🚀 Key Features

✅ Automated CAMELS downloader:

  * Downloads basin attributes, meteorological forcing data (including optional extended forcing), and observed streamflow data.

✅ Data preparation pipeline:

  * Merges static basin attributes.
  * Processes Daymet, Maurer-extended, and NLDAS-extended forcing datasets.
  * Computes **Potential Evapotranspiration (PET)** using the Hargreaves method.
  * Calculates **Runoff**.
  * Generates a standardized NetCDF file (`CAMELS.nc`).

✅ Data normalization and denormalization utilities** to streamline modeling workflows.


If you use this pipeline or data in your research, please cite:

> Liu, J., Bian, Y., Lawson, K., & Shen, C. (2024). Probing the limit of hydrologic predictability with the Transformer network. *Journal of Hydrology*, 637, 131389. https://doi.org/10.1016/j.jhydrol.2024.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, 1-21. https://doi.org/10.5194/egusphere-2025-1706