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

This resource contains some files/folders that have non-preferred characters in their name. Show non-conforming files/folders.

This resource contains content types with files that need to be updated to match with metadata changes. Show content type files that need updating.

NextGEN Modeling Tutorial

Authors:
Owners:		This resource does not have an owner who is an active HydroShare user. Contact CUAHSI (help@cuahsi.org) for information on this resource.
Type:	Resource
Storage:	The size of this resource is 100.4 KB
Created:	Nov 03, 2025 at 7:06 p.m. (UTC)
Last updated:	Nov 08, 2025 at 9:53 p.m. (UTC)
Citation:	See how to cite this resource

Sharing Status:	Public
Views:	50
Downloads:	0
+1 Votes:	Be the first one to this.
Comments:	No comments (yet)

Abstract

This hydroShare resource contains Python code and Jupyter Notebooks with step-by-step instructions to set up, run, and analyze the results from a NextGEN model configured for research over a small watershed using the CIROH-2i2c Jupyterhub Community NextGen hub.

The workflow is organized into four modular Jupyter Notebooks:

NextGen Data Preparation – Subsets the hydrofabric for a user-defined area of interest, generates meteorological forcings, and configures model parameters and realizations for a default NextGen model formulation in each catchment.

NextGen Run – Executes the model using default parameter configurations.

NextGen Output Analysis – Evaluates and visualizes water balance components and other model outputs for post-processing and interpretation.

Several Python utility scripts support the workflow by providing tools for data subsetting, visualization, model execution, calibration, and output analysis.

Subject Keywords

Deleting all keywords will set the resource sharing status to private.

Coverage

Spatial

Coordinate System/Geographic Projection:

WGS 84 EPSG:4326

Coordinate Units:

Decimal degrees

Place/Area Name:

CONUS

North Latitude

49.8040°

East Longitude

-65.4594°

South Latitude

24.6390°

West Longitude

-124.8739°

Content

Learn more about the BagIt download

Select a file to see file type metadata.

README.md

🌊 NextGen Hydrologic Modeling Tutorial

This HydroShare resource provides Python code and Jupyter Notebooks with step-by-step instructions to set up, run, and analyze the results from a NextGEN model configured for research over a small watershed using theCIROH-2i2c Jupyterhub Community NextGen hub.

📦 Contents

1. Jupyter Notebooks

🧭 `NextGen_Data_Preparation.ipynb`

Subsets the hydrofabric dataset, AORC forcings, and sets up the model configuration and realization for CFE and Noah-OWP.

🚀 `NextGen_Run.ipynb`

Executes the NextGen hydrologic model using the default configuration and parameter values.

📊 `NextGen_Output_Analysis.ipynb`

Analyzes and evaluates model output using water balance components.
Enables post-processing and visualization of results for interpretation and reporting.

2. Python Utility Files

Utility File	Purpose
`forcings_visualization_utils.py`	Visualization of meteorological forcing data
`hydrofabric_visualization_utils.py`	Visualization of hydrofabric data
`ngen_outputs_utils.py`	Analysis and visualization of model outputs

🔁 Workflow Summary

Prepare Inputs – Define the area of interest, subset the hydrofabric, and generate AORC forcings.
Run the Model – Execute the NextGen model using the prepared inputs and default parameter settings.
Analyze Outputs – Evaluate water balance components and visualize results.

👥 Intended Audience

This resource is ideal for:
- Researchers exploring watershed behavior and hydrologic processes
- Practitioners building custom modeling workflows for operational applications
- Educators teaching hydrologic modeling and reproducible workflows

📘 Getting Started

Launch the Jupyter Notebooks using the CIROH-2i2c Jupyterhub Community NextGen hub configuration.
Start with NextGen_Data_Preparation.ipynb to prepare inputs.
Proceed to NextGen_Run.ipynb to execute the model.
Finish with NextGen_Output_Analysis.ipynb to analyze and visualize results.

🛠️ Preparation

To access CIROH-2i2c JupyterHub you need to request Individual CIROH-2i2c JupyterHub CPU Access at https://docs.ciroh.org/docs/services/access#accessing-ciroh-jupyterhub. This requires a github account.

📦 Dependencies

This resource is set up to work with the CIROH-2i2c JupyterHub CIROH Community NextGen hub configuration. This has the content from NextGen in a Box and NGIAB data preprocess

🙏 Acknowledgments

This research was supported by the Cooperative Institute for Research to Operations in Hydrology (CIROH) with funding under award NA22NWS4320003 from the NOAA Cooperative Institute Program. The statements, findings, conclusions, and recommendations are those of the authors and do not necessarily reflect the opinions of NOAA.

Credits

Funding Agencies

This resource was created using funding from the following sources:

Agency Name	Award Title	Award Number
National Oceanic and Atmospheric Administration (NOAA), University of Alabama	CIROH: Enabling collaboration through data and model sharing with CUAHSI HydroShare	NA22NWS4320003 to University of Alabama, subaward A23-0266-S001 to Utah State University

How to Cite

Nassar, A., D. Tarboton, F. Baig (2025). NextGEN Modeling Tutorial, HydroShare, http://www.hydroshare.org/resource/0580878f98d548b08923b780e667c396

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

http://creativecommons.org/licenses/by/4.0/

Comments

There are currently no comments

Notifications (${tasks.length})