openkarhydro 0.1.0

Solar Farm hydrological model for photovoltaic stations

OpenKarHydro

光伏电站水文生态过程模拟工具。

基于 SOFAR 2.3 + 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

输出文件：

文件	格式	说明
timeseries.csv	CSV	逐日时间序列（Excel 可用）
results.sqlite	SQLite	日/月/年表 + 空间统计（QGIS 可查）
*.LDASOUT_DOMAIN1.nc	NetCDF	CF-1.6 空间格点数据（QGIS 直接打开）

QGIS 插件

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

参考文档

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