CIROH DevCon 2025 Workshop: Hydrological Model Calibration in the NGIAB Ecosystem

Welcome to the GitHub Wiki for the CIROH DevCon 2025 workshop

Workshop Details

• 📅 Date: Thursday, May 29, 2025
• ⏰ Time: 1:30 PM – 3:00 PM (US Eastern Time)
• 📍 Location: UVM Dudley H. Davis Center – Level 4, 590 Main Street, Burlington, VT 05405
• 🏛️ Organized by: Cooperative Institute for Research to Operations in Hydrology - CIROH

🚀 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.

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.