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. Ways to run NGIAB | How do I execute a NextGen run? |
| Duration: 00h 37m | 4. NGIAB-related Software |
What software components are commonly used in a NextGen
workflow? What role does each tool play in preparing, running, and analyzing NextGen simulations? :::::::::::::::::::::::::::::::::::::::::::::::: |
| Duration: 00h 47m | 5. Community Hydrofabric | How does the Community Hydrofabric support NGIAB workflows? |
| Duration: 01h 37m | 6. Data Preprocessor |
How should I prepare my run directory? What is the Data Preprocess tool? |
| Duration: 02h 27m | 7. TEEHR | How do I use Tools for Exploratory Evaluation in Hydrologic Research (TEEHR) to evaluate my NextGen models in NGIAB? |
| Duration: 02h 42m | 8. Visualization | How do I visualize my NextGen runs? |
| Duration: 02h 57m | 9. Calibration | How do I calibrate parameters for a NextGen run? |
| Duration: 03h 22m | 10. 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? Are there other ways I can run NGIAB? How can I contribute to NGIAB? How can new models be integrated into NGIAB and NextGen? |
| Duration: 04h 27m | 11. Model Integration |
What makes a model compatible with NGIAB and the NextGen
framework? How do I integrate my own model into NGIAB? |
| Duration: 05h 27m | 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 Glossary may be a useful reference. 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.
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.
2i2c Users
Are you planning on running NGIAB through CIROH-2i2c JupyterHub? If so, you do not need to install Docker, NGIAB, or supporting software on your local machine. Instead, request access to CIROH-2i2c through the Infrastructure Access page, launch a CIROH Community NextGen Hub server, and follow the Jupyter notebook workflows provided in the cloud environment.
You may still find the Installation episode useful for understanding the NGIAB ecosystem, but local software installation steps can be skipped.
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