SuperAPI AI 工具集

pybamm

通用与其它

查看项目

更新于 10-15 23:43

技能介绍

用途:在单电芯层面建模恒流充电、放电与静置实验,查看电压与容量轨迹,或将 SPM/DFN 预测与循环测量对比。该技能运行真实 PyBaMM 实验并做三种数值分辨率比较,不控制电池测试柜,也不为硬件确定工作包络。

环境与版本:uv venv --python 3.12 battery-env;uv pip install --python battery-env/bin/python pybamm==26.9.0.0 pybammsolvers==0.10.0。该版本要求 pybammsolvers>=0.10.0、NumPy 2 或更新版本、CasADi 3.8.1;测试环境为 Python 3.12.10、NumPy 2.5.3、SciPy 1.18.1。推荐 IDAKLU 求解器,CasadiSolver 与 ScipySolver 已弃用。请参照 26.9.0.0 手册,最新文档可能描述未发布 API。

参考算例:assets/chen2020-protocol.json 是合成等温 298.15 K 的 SPM 工况:初始 SOC 80%,0.5C 放电 600 秒,静置 120 秒,0.5C 充电 600 秒。Chen2020 提供 LG M50 参数化,标称容量 5 Ah,故 0.5C 为 2.5 A;这只是可执行参考,不代表任意用户电芯具有该参数。除非调用方已显式配置,助手会禁用 PyBaMM 使用遥测。

用法:先用 battery-env/bin/python scripts/simulate_battery.py assets/chen2020-protocol.json --output battery-reference 运行参考算例;有测量数据时用 --measured measured.csv --mesh-points 30 --output battery-comparison。测量 CSV 需含 time_s、voltage_V、current_A 列。输出目录必须为新目录。

输出物:curve.csv(基线时间、步、电压、电流与净放电容量)、tight-tolerance.csv、refined-mesh.csv、parameters.json、report.json、measurement-residuals.csv(提供测量时)。

限制:测试模型为等温,不含老化、力学、镀锂与电池组控制;更大倍率可能使 SPM 预测失效,即使数值收敛良好。电压残差小不能验证电流输入不匹配的模型,该流程只比较曲线,不声称仅从电压识别唯一动力学参数。