OpenKarHydro

人类活动（梯田撂荒、光伏电站、城市化）对水文循环与土壤侵蚀影响的评估工具。

基于 NOAH-MP 物理过程，用 Python 重写的开源水文生态模拟模型。能够模拟梯田撂荒、光伏电站建设、城市化等人类活动对局地水文循环和土壤侵蚀过程的影响。

安装

pip install openkarhydro

需要 Python 3.12+。

快速开始

# 创建新项目
openkarhydro init my_project
cd my_project

# 将 DEM、气象数据放入 inputs/ 目录
# 编辑 config.yaml 配置参数

# 运行模拟
openkarhydro run config.yaml --output outputs/

# 后处理（生成 SQLite + 空间统计）
openkarhydro postprocess outputs/ --db outputs/results.sqlite

输出文件：

QGIS 插件

安装核心包后，在 QGIS 中搜索 OpenKarHydro 插件安装，即可在界面中完成项目创建、模型运行、结果可视化的全流程操作。

参考文档

• DEVELOPMENT_DESIGN.md — 架构设计
• HPC_GUIDE.md — 超算使用指南
• QGIS_PLUGIN_DESIGN.md — QGIS 插件设计