Checking for non-preferred file/folder path names (may take a long time depending on the number of files/folders) ...

SUMMA Simulations using CAMELS Datasets on CyberGIS-Jupyter for Water

Owners: This resource does not have an owner who is an active HydroShare user. Contact CUAHSI ( for information on this resource.
Type: Resource
Storage: The size of this resource is 8.8 MB
Created: Mar 04, 2021 at 5:49 p.m.
Last updated: May 05, 2021 at 8:33 p.m.
Citation: See how to cite this resource
Sharing Status: Public
Views: 1054
Downloads: 54
+1 Votes: Be the first one to 
Comments: No comments (yet)


This resource, configured for execution in connected JupyterHub compute platforms, helps the modelers to reproduce and build on the results from the paper (Van Beusekom et al., 2021). For this purpose, three different Jupyter notebooks are developed and included in this resource which explore the paper goal for one example CAMELS site and a pre-selected period of 18-month simulation to demonstrate the capabilities of the notebooks. The first notebook processes the raw input data from CAMELS dataset to be used as input for SUMMA model. The second notebook executes SUMMA model using the input data from first notebook using original and altered forcing, as per further described in the notebook. Finally, the third notebook utilizes the outputs from notebook 2 and visualizes the sensitivity of SUMMA model outputs using Kling-Gupta Efficiency (KGE). More information about each Jupyter notebook and a step-by-step instructions on how to run the notebooks can be found in the fie included in this resource. Using these three notebooks, modelers can apply the methodology mentioned above to any (one to all) of the 671 CAMELS basins and simulation periods of their choice.

Subject Keywords



Coordinate System/Geographic Projection:
WGS 84 EPSG:4326
Coordinate Units:
Decimal degrees
Place/Area Name:
North Latitude
East Longitude
South Latitude
West Longitude


Start Date:
End Date:


How to run the simulations

This Readme file provides the users with the step-by-step guide to successfully run the three developed notebooks.
The steps, in the order they need to be taken, are explained in what follows.

STEP_0 Preliminary step

In this step the modellers make sure that they have access to the content files of the resource and required compute platform.
- In order to be able to run the three Jupyter notebooks, modelers need to first have a HydroShare account.
- If the modeler already does not have access to CyberGIS-Jupyter for Water (CJW), they need to ask to get access to it at the CyberGIS-Jupyter for Water platform

Important notes before running the notebooks:
- Users can change the HRU ID and simulation periods to analyze any of the 671 basins in CAMELS datasets for the simulation period of their choice.
- To run each notebook:
1. Click the OpenWith button in the upper-right corner of this HydroShare resource webpage;
2. Select "CyberGIS-Jupyter for Water";
3. Open the notebook and follow instructions;

STEP_1 Create SUMMA input using 1_camels_make_input.ipynb

The first notebook creates SUMMA input using Camels dataset using in this resource and OpenDAP resource.

STEP_2 Execute SUMMA using 2_camels_pysumma.ipynb

This notebook executes SUMMA using original and constant forcing, and different parameters and parameterization combinations.

STEP_3 Visualize SUMMA output using 3_camels_analyze_output.ipynb

The final notebook visualizes the sensitivity of SUMMA output according to the constant forcing and output variables using KGE (Kling-Gupta Efficiency).

Related Resources

This resource is referenced by Van Beusekom, A., Hay, L, (in no particular order -->) Nijssen, B., Bennett, A., Tarboton, D., Wood, A., Choi, Y., Li, Z., Maghami, I., Clark, M., Goodall, J.L. “Hydrologic model sensitivity to temporal disaggregation of meteorological forcing data across CONUS” (In preparation for …)
The content of this resource is derived from


Funding Agencies

This resource was created using funding from the following sources:
Agency Name Award Title Award Number
National Science Foundation Collaborative Research: SI2-SSI: Cyberinfrastructure for Advancing Hydrologic Knowledge through Collaborative Integration of Data Science, Modeling and Analysis OAC-1664061, OAC-1664018, OAC-1664119

How to Cite

Choi, Y., A. Van Beusekom, Z. (. Li, B. Nijssen, L. Hay, A. Bennett, D. Tarboton, I. Maghami, J. Goodall, M. P. Clark (2021). SUMMA Simulations using CAMELS Datasets on CyberGIS-Jupyter for Water, HydroShare,

This resource is shared under the Creative Commons Attribution CC BY.


There are currently no comments

New Comment