Summary and Schedule
This is a new lesson built with The Carpentries Workbench.
| Setup Instructions | Download files required for the lesson | |
| Duration: 00h 00m | 1. Introduction |
What is the NextGen Framework? What is NextGen in a Box (NGIAB)? What is containerization? Why should I use NGIAB? |
| Duration: 00h 15m | 2. Installation and Setup |
How do I install and set up NGIAB? What are the prerequisites for running NGIAB? How do I verify my installation? |
| Duration: 00h 27m | 3. Data Preparation |
How should I prepare my run directory? What is the Data Preprocess tool? |
| Duration: 01h 17m | 4. Model Execution | How do I execute a NextGen run? |
| Duration: 01h 27m | 5. Evaluation | How do I use Tools for Exploratory Evaluation in Hydrologic Research (TEEHR) to evaluate my NextGen models in NGIAB? |
| Duration: 01h 42m | 6. Visualization | How do I visualize my NextGen runs? |
| Duration: 01h 57m | 7. Advanced Topics |
How do I use NGIAB on an high-performance computing (HPC)
system? How do I use the Data Visualizer through an SSH connection? How can I contribute to NGIAB? |
| Duration: 03h 02m | Finish |
The actual schedule may vary slightly depending on the topics and exercises chosen by the instructor.
Welcome to the NextGen In A Box (NGIAB) 101 training module!
Source Code and Documentation
The source code for NextGen In A Box (NGIAB) is found at our GitHub repository. The documentation for NGIAB and its extensions are found on the CIROH docs.
To dive right into NGIAB as quickly as possible, follow the quick start guide on our GitHub repository, or head straight to our second episode, Installation. If you are interested in taking your time and learning in-depth about the features of NGIAB, follow the episodes in this module.
For all users, the Key Points summary page and the Glossary may be useful references. The Advanced Topics episode is optional, but may contain useful content depending on your specific use case.
Note: This module requires you to use Bash scripting in your command line and Git. All commands will be given in this module. However, if you are interested in learning more, you can refer to this quick Bash tutorial by Ubuntu, this basic Git tutorial in the Git documentation, and this Git workflow tutorial by CIROH.
DevCon 2025 NGIAB Workshop Attendees
Are you joining us for the DevCon 2025 NGIAB workshop? We have prepared two DevCon-specific documents for you.
- DevCon 2025 Jetstream Instructions will walk you through the specific steps we will take in this hands-on workshop.
- DevCon 2025 Troubleshooting contains useful reference material if you are stuck during the workshop.
These documents are key, since we will not be following the default episodes exactly as written.
After the workshop, feel free to explore the rest of this module to learn more about NGIAB!
HPC Users
Are you planning on running NGIAB on an HPC? You can follow the episodes in order, but replace Episode 2: Installation and Setup with the HPC-specific instructions in the Advanced Topics module.
System Requirements
The Installation episode will walk you through the steps to install Windows Subsystem for Linux (WSL), Docker, NGIAB, and retrieve sample data sets. This page summarizes system requirements.
- Software: Docker, Git, WSL, Astral UV
- Recommended Minimum RAM: 8 GB
- Software: Docker, Git, Astral UV
- Recommended Minimum RAM: 8 GB
-
Software: Docker, Git, Astral UV
- Recommended Minimum RAM: 8 GB