Data for Implementing BMI for the HBV Hydrological Model: A Case Study in NextGen Modeling Framework Integration

The Basic Model Interface (BMI) and Next Generation National Water Model (NextGen) framework have been developed to enable interoperability between distinct hydrologic models and model process components within large-scale (up to continental) modeling systems. This approach recognizes that no single model or component is universally optimal for all processes or locations. This paper explores the refactoring and wrapping of a hydrologic model and its components in BMI to be included in and support multi-model mosaics and models composed of compatible component modules. As a case study an R implementation of the Hydrologiska Byråns Vattenbalansavdelning (HBV) model was refactored and reimplemented in Python, a language supported by BMI, using Object-Oriented Programming (OOP) principles. The model was then wrapped with BMI functions, enabling its deployment in multi-model, mosaic-style modeling simulations. Each of the HBV’s four routines was further componentized into individual BMI-compliant components, resulting in reusable and importable modules. These components were successfully integrated into the NextGen framework to perform component-based hydrological simulations across multiple formulations. This work demonstrates the feasibility and benefits of using BMI to standardize the coupling of hydrological models and modularize their sub-components, ultimately fostering increased collaboration, reusability, and flexibility across modeling applications. It also provides a practical road map for converting a Python-based hydrological model into a BMI-compliant model component to promote model interoperability and reusability.基本模型接口（Basic Model Interface，BMI）与下一代国家水文模型（Next Generation National Water Model，NextGen）框架已被开发，用于实现大型（乃至大陆级）建模系统中不同水文模型及模型过程组件间的互操作性。该方案认识到，不存在任何单一模型或组件可在所有过程与场景下实现全局最优性能。本文探讨了将某水文模型及其组件进行重构与封装并适配BMI标准的方法，以使其能够被纳入多模型镶嵌式架构，以及由兼容组件模块构成的复合模型之中。作为案例研究，研究人员基于面向对象编程（Object-Oriented Programming，OOP）原则，将瑞典水文气象局水文平衡分部（Hydrologiska Byråns Vattenbalansavdelning，HBV）模型的R语言实现重构，并在BMI支持的Python语言中重新实现。随后，通过BMI函数对该模型进行封装，使其可部署于多模型镶嵌式建模模拟任务中。HBV模型的四个核心程序均被进一步组件化为独立的符合BMI标准的组件，最终得到可复用、可导入的模块化组件。这些组件已成功集成至NextGen框架中，可基于多种公式开展基于组件的水文模拟。本研究验证了使用BMI标准化水文模型耦合流程并模块化其子组件的可行性与优势，最终可推动建模应用场景中协作效率、复用性与灵活性的提升。同时，本研究也为将基于Python的水文模型转换为符合BMI标准的模型组件提供了实用路线图，以促进模型互操作性与复用性的发展。