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

Provo River near Woodland (gage-10154200) NGIAB Case Study (calibrated)
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 876.9 MB
Created: Mar 25, 2025 at 1:54 p.m. (UTC)
Last updated: Jul 24, 2025 at 9:21 p.m. (UTC)
Citation: See how to cite this resource
Sharing Status: Public
Views: 723
Downloads: 0
+1 Votes: Be the first one to 
 this.
Comments: 1 comment

Abstract

The U.S. National Water Model (NWM) provides continental-scale hydrological forecasts, but its complexity makes deployment and customization on researchers' computing resources challenging for local and regional studies. The Next Generation Water Resources Modeling Framework (NextGen) enhances model flexibility and interoperability, yet deploying it independently remains demanding. To address this, we developed the NextGen In A Box (NGIAB) to provide a containerized solution for simplified NextGen deployment on local machines, high-performance computing (HPC) clusters, and cloud environments. NGIAB leverages Docker and Singularity containers, pre-configured with core components expected in forthcoming NWM version 4.0. This integrates input datasets, forcing engines, and necessary libraries, enabling seamless execution. Developed by CIROH and Lynker, NGIAB’s cyberinfrastructure features cloud-based data access, a robust CI/CD pipeline, and streamlined Basic Model Interface (BMI) coupling. By lowering technical barriers, NGIAB enables researchers to efficiently run localized models, promoting community engagement in hydrologic modeling and facilitating research-to-applications pathways.

Subject Keywords

Coverage

Spatial

Coordinate System/Geographic Projection:
WGS 84 EPSG:4326
Coordinate Units:
Decimal degrees
Place/Area Name:
Provo River near Woodland UT
Longitude
-111.1688°
Latitude
40.5577°

Temporal

Start Date:
End Date:

Content

readme.md

Running NGIAB, TEEHR Evaluation and Tethys Visualizer

Installation and Setup Instructions

Follow these steps to set up and run the NGIAB, TEEHR Evaluation and Tethys Visualizer:

  1. Download the provided zip folder
  2. Extract the zip folder to your preferred location
  3. Clone the NGIAB-CloudInfra Infrastructure repository: git clone https://github.com/CIROH-UA/NGIAB-CloudInfra.git
  4. Navigate to the cloned repository: cd NGIAB-CloudInfra
  5. Run the setup guide script: ./guide.sh
  6. When prompted, provide the absolute path to the folder extracted in step 2

After completing these steps, follow the prompts to get the output plot shown below:

gage-10154200 Output Plot showing TEEHR metrics

How We Generated the Input Data (gage-10154200) on Jetstream2

Versions Used

Jetstream2 Instance Configuration

  • Flavor: m3.2xl
  • vCPUs: 64
  • RAM: 250 GB
  • Local Storage: 60 GB

Data Preparation Commands

To obtain the necessary data (the "zip folder" referenced in step 2), we executed the following commands on a Jetstream2 instance:

Step 1: Data Preprocessing

uvx ngiab-prep -i gage-10154200 -sfr --start 2017-01-01 --end 2023-01-02

This command prepares the input data for the workflow.

📚 Learn more: NGIAB Data Preprocess Repository

Command Arguments Explained:

  • -i INPUT_FEATURE - ID of feature to subset (supports prefixes like cat-5173, gage-01646500, or wb-1234)
  • -s, --subset - Subset the hydrofabric to the given feature
  • -f, --forcings - Generate forcings for the given feature
  • -r, --realization - Create a realization for the given feature
  • --start - Start date for forcings/realization (format: YYYY-MM-DD)
  • --end - End date for forcings/realization (format: YYYY-MM-DD)
  • -g, --gage - Use gage ID instead of catid

Step 2: Model Calibration

uvx ngiab-cal ~/ngiab_preprocess_output/gage-10154200 -i 200 -g 10154200 --run -f --cr 0.8

This command performs model calibration using the prepared data.

📚 Learn more: NGIAB Calibration Repository

Calibration Arguments:

  • data_folder - Path to the folder you wish to calibrate
  • -g GAGE - Gage ID to use for calibration
  • -f, --force - Overwrite existing configuration
  • --run - Automatically run the calibration (may be unstable)
  • -i ITERATIONS - Number of iterations to calibrate for (default: 100)
  • --calibration_ratio - Split ratio for calibration vs validation data
  • 1.0 = 100% calibration, 0% validation
  • 0.8 = 80% calibration, 20% validation
  • 0.5 = 50% calibration, 50% validation (default)

Output Location

Once these commands finish running, the output folder containing the necessary data will be located at:

~/ngiab_preprocess_output/gage-10154200

Credits

Funding Agencies

This resource was created using funding from the following sources:
Agency Name Award Title Award Number
NOAA Cooperative Institute Program NA22NWS4320003

How to Cite

Patel, A., M. Singh (2025). Provo River near Woodland (gage-10154200) NGIAB Case Study (calibrated), HydroShare, http://www.hydroshare.org/resource/88e0ebf2719c492381efcb27fba71032

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

 http://creativecommons.org/licenses/by/4.0/
CC-BY

Comments

New Comment

required