NWC-CUAHSI Summer Institute 2025: Workshop on Hydrological Model Calibration in the NGIAB Ecosystem

Welcome to the GitHub Wiki for the NWC-CUAHSI Summer Institute 2025 Workshop

Workshop Details

• 📅 Date: Thursday, June 18, 2025
• ⏰ Time: Wednesday, June 18 | 10:45 – 12 pm CT
• 📍 Location: Cyber Hall GWSC classroom, Room number 1160, 248 Kirkbride Ln, Tuscaloosa, AL 35401
• 🏛️ Organized by: CUAHSI and The University of Alabama

👥 Instructors

This GitHub [wiki] repository, which serves as the central hub for all workshop materials, tools, detailed instructions, pre-conference and other relevant information, was prepared and is maintained by Sifan A. Koriche and Josh Cunningham.

🚀 Ready to start? Jump to our Quickstart Guide to begin calibrating in minutes!

Workshop Purpose

This workshop offers a comprehensive guide to hydrological model calibration, regionalization, and parameter sharing within the NextGen In A Box (NGIAB) ecosystem. Participants will gain hands-on experience calibrating models using open-source tools and pre-made data with NGIAB and NGEN-Cal Docker images.

Learning Objectives

By the end of this workshop, participants will learn:

• ✅ Model calibration fundamentals - Learn the theoretical underpinnings of model calibration and its role in improving hydrological model accuracy
• ✅ Hands-on NextGen Experience - Complete a full model calibration workflow within the NextGen/NGIAB ecosystem using open-source tools
• ✅ Parameter sharing - Explore tools and methods for effectively managing calibrated parameters in collaborative environments
• ✅ Best Practices - Discuss challenges and best practices with peers and instructors

Figure 1: End-to-end visual representation of the NextGen In A Box (NGIAB) ecosystem's hydrological simulation workflow, detailing phases for data preparation, model simulation, parameter calibration, and output analysis steps. 1) Python CLI data preparation modules for NGIAB, 2a) NGIAB Docker image, 2b) NGIAB-cal Docker image + Python CLI for Calibration, and 3) TEEHR evaluation + visualizer.

[graphics by Sifan A. Koriche]

Navigation

Get Started Quickly

• 🚀 Quickstart Guide - Start calibrating in minutes!

Workshop Resources

• What is NextGen? - Understanding the framework
• Workshop Materials - Slides and datasets
• Pre-Workshop Checklist - Setup requirements

Detailed Instructions

• Step-by-Step Instructions - Comprehensive tutorial
• Tools and Modules - Understanding the components
• Workflow Process - How everything fits together

Advanced Topics

• Development Setup - Modify and extend the tools
• Directory Structure - Understanding file organization

Support

• Troubleshooting - Common issues and solutions
• Contact and Acknowledgment - Get help and support

Prerequisites

This workshop requires Docker and UV.

📋 Complete setup instructions: Pre-Workshop Checklist

---

New to hydrological model calibration? Start with What is NextGen? to understand the framework, then move to the Quickstart Guide for hands-on experience.

Experienced users? Jump straight to the Quickstart Guide or Step-by-Step Instructions for detailed workflows.