ravens-hydro 0.3.1

Raven-hydro是一个基于Python的水文建模框架Raven的安装器。

• 自由软件：Apache软件许可证v2.0

关于

Raven 是一个水文建模框架，允许水文学家通过组合不同的水文过程来构建水文模型。它还可以用来模拟各种现有的集中式和分布式模型。模型结构、参数、初始条件和强迫文件在文本文件中配置，Raven 解析这些文件以构建和运行水文模拟。有关 Raven 的建模能力的详细描述，请参阅 文档。

目的

本项目的目标是使用 scikit-build-core 和 pybind11 为 Raven 水文模型提供一个基于 Python 的多平台安装程序。编译的二进制文件支持 NetCDF4，并使用自定义的 CMakeLists.txt，而不是 Raven 源代码 中提供的，以便利用 pip 处理二进制文件和库的安装和管理。

本项目通过提供专门的库来支持 RavenPy，该库可以用于在多个平台上下载、编译和安装 Raven 二进制文件（默认支持 NetCDF4），同时通过 pip/PyPI 提供版本控制和更新。

Raven 的源代码不包括在本存储库中，但会在安装过程中从 RavenHydroFramework GitHub 仓库 的发布中获取并编译。

功能

• 通过 pip/PyPI 下载、编译、版本控制和 Raven 水文模型的包更新
• 保留版权声明和许可信息
• 多平台支持（macOS、Linux、Windows、BSD 等）

安装

警告 默认情况下，此 Raven 版本需要系统上安装 NetCDF4 库，将其暴露在 $PATH 上，并且可以使用 FindNetCDF.cmake 辅助脚本来发现。

在 Linux 上，这可以通过 libnetcdf-dev 系统库提供；在 macOS 上通过 netcdf homebrew 软件包提供；在 Windows 上通过使用 UNIDATA 的 预构建的二进制文件 提供。

这也可以通过在 conda-forge 可用的 libnetcdf 软件包提供，尽管在撰写本文时这并不保证在 macOS 上可以正常工作（需要进一步研究）。

可以使用以下命令从 PyPI 安装 raven-hydro

$ pip install raven-hydro

从 PyPI 安装 raven-hydro（不包含 NetCDF 支持）

$ pip install raven-hydro -Ccmake.define.USE_NETCDF=false

出于开发目的，我们建议克隆存储库并执行 --editable 安装

$ git clone git@github.com:Ouranosinc/raven-hydro
$ cd raven-hydro
$ pip install --editable .