NextGen Water Modeling Workflow for Research-Scale Applications

This HydroShare resource delivers a complete, modular workflow for implementing the Next Generation Water Modeling Framework (NextGen) using cloud-based or containerized computing environments. The workflow guides users through each key component of a research-scale hydrologic modeling application, including model input data preparation, model configuration and execution, calibration, and performance evaluation. To run this workflow, users must launch the resource within an interactive computing environment. From the HydroShare \"Open With\" web app connector, select \"CIROH-2i2c JupyterHub\", then choose the pre-configured \"CIROH Community NextGen Hub\" image. This environment includes all required NextGen tools and dependencies to ensure consistent, reproducible execution. The workflow is organized into five interoperable Jupyter Notebooks that can be executed independently or as a full end-to-end sequence: 1. NextGen Data Preparation – Subsets the hydrofabric for a user-defined Area of Interest (AOI), generates meteorological forcing data, and creates model configuration files and realizations for CFE and Noah-OWP model components. 2. NextGen Run – Executes the NextGen model using default configurations to establish baseline simulation performance. 3. NextGen TEEHR Evaluation – Compares simulated streamflow results with USGS observations and the National Water Model Retrospective Analysis v3.0 using TEEHR (Tools for Exploratory Evaluation in Hydrologic Research). 4. NextGen Output Analysis – Visualizes water balance components and other model outputs for interpretation and post-processing. 5. NextGen Calibration – Applies SPOTPY-based optimization to improve model performance through automated streamflow calibration. A lightweight Python wrapper, pyngiab.py, streamlines interaction with the NextGen model engine by managing configuration loading, model execution, and output organization directly from the notebooks. Supplementary Python utility scripts support data subsetting, visualization, calibration, programmatic execution, and reproducible model management. Together, these components establish a transparent, adaptable, and fully traceable workflow to support collaborative hydrologic research, model testing, and community-driven advancement of the NextGen framework.本HydroShare资源提供了一套完整的模块化工作流，可在基于云或容器化的计算环境中部署实施下一代水文建模框架（NextGen）。该工作流将引导用户完成研究级水文建模应用的全部核心环节，涵盖模型输入数据制备、模型配置与运行、率定以及性能评估。 若要运行该工作流，用户需在交互式计算环境中启动本资源。通过HydroShare的"Open With"网页应用连接器，选择"CIROH-2i2c JupyterHub"，随后选取预配置的"CIROH Community NextGen Hub"镜像。该环境内置所有所需的NextGen工具与依赖项，可确保运行结果一致且可复现。 本工作流由五个可互操作的Jupyter Notebook组成，既可以独立运行，也可按完整的端到端序列执行： 1. NextGen数据制备：针对用户自定义的关注区（Area of Interest, AOI）裁剪水文剖分数据集（hydrofabric），生成气象强迫数据，并为CFE与Noah-OWP模型组件创建模型配置文件与模型实例。 2. NextGen运行：采用默认配置运行NextGen模型，以确立基准模拟性能。 3. NextGen TEEHR评估：采用水文研究探索性评估工具（Tools for Exploratory Evaluation in Hydrologic Research, TEEHR），将模拟径流结果与美国地质调查局（USGS）观测数据以及国家水文模型回顾性分析v3.0进行对比。 4. NextGen输出分析：可视化水量平衡组分与其他模型输出结果，以便解读与后处理。 5. NextGen率定：采用基于SPOTPY的优化方法，通过自动化径流率定提升模型性能。 一款轻量级Python封装工具pyngiab.py，可直接在Notebook中管理配置加载、模型运行与结果组织，从而简化与NextGen模型引擎的交互流程。 配套的Python实用脚本可支持数据裁剪、可视化、率定、程序化运行以及可复现的模型管理。上述组件共同构建了一套透明、可扩展且完全可溯源的工作流，可为协同水文研究、模型测试以及社区驱动的NextGen框架迭代升级提供支撑。