p
pnflly/aimnet2-wb97m-d3
Model Introduction
Files & versions
Pull Requests
Discussion
Analysis

AIMNet2-wB97M-D3 昇腾 NPU 推理服务

面向化学与材料领域研究者:把神经网络势能模型 AIMNet2(wB97M-D3 训练集)部署到 华为昇腾 NPU,用 HTTP 接口完成"输入分子结构,输出能量/电荷/力"的分子性质预测。

一、简介

AIMNet2 用原子环境向量(AEV)+ 消息传递 MLP 表征分子局域环境,相比传统 DFT 快 若干个数量级,能量精度接近密度泛函水平。本项目将原版 HuggingFace 权重适配到 昇腾 910B 上,提供开箱即用的服务化推理,无需任何 CUDA 环境。

能做什么:

  • 计算中性/带电小分子的 wB97M-D3 单点总能量(含 DFT-D3BJ 色散与库仑修正)
  • 输出原子级部分电荷(天然满足电荷守恒)
  • 可选输出原子力(用于几何优化、分子动力学起步)
  • 批量处理多个分子

覆盖元素: H B C N O F Si P S Cl As Se Br I(14 种)

二、验证环境

项目配置
处理器平台aarch64 Linux(kernel 5.10)
加速卡Ascend 910B(单卡双 chip)
CANN 版本8.5.1
深度学习框架torch 2.9.0 + torch_npu 2.9.0.post1
推理服务FastAPI + Uvicorn
Python3.11

我们在 npu:1 上完成验证;同机 npu:0 用于其他任务,互不干扰。

三、服务启动

3.1 安装依赖

pip install -r requirements.txt

3.2 下载权重

权重来自 isayevlab/aimnet2-wb97m-d3,共 4 个 safetensors 成员(每个约 8.8MB)。 放置路径可自定义,通过环境变量 AIMNET2_MODEL_DIR 指定。

3.3 运行服务

# 建议先准备本地编译缓存目录
mkdir -p /tmp/ascend_work /tmp/ascend_cache /tmp/ascend_log

AIMNET2_DEVICE=npu:1 AIMNET2_PORT=18222 python3 serve.py

就绪判定: 看到日志 Application startup complete. 且 curl http://127.0.0.1:18222/health 返回 "status":"ok" 即成功。

四、Smoke 验证

三分钟内快速验证部署是否可用:

# 1. 存活探针
curl -s http://127.0.0.1:18222/health

# 2. 模型元信息
curl -s http://127.0.0.1:18222/v1/models

# 3. 水分子预测
curl -s -X POST http://127.0.0.1:18222/predict -H 'Content-Type: application/json' \
  -d '{"numbers":[8,1,1],"coord":[[0,0,0],[0.9584,0,0],[-0.2400,0.9271,0]],"compute_forces":true}'

第 3 步应返回类似:

{
  "energy_eV": -2081.0499,
  "energy_Ha": -76.4772,
  "charges": [-0.695, 0.347, 0.347],
  "forces": [[0.058, 0.024, -0.0], [-0.001, -0.049, -0.0], [-0.057, 0.025, -0.0]],
  "runtime_ms": 31.8
}

五、性能参考

以下数据来自 2026-08-22 昇腾 910B 实测(服务运行于 npu:1):

场景指标数值
预热后单点预测服务内延迟15–38 ms
并发吞吐(8 路压测)完成量180 请求 / 4 s
冷启动首次请求含算子编译~80 s
常驻资源进程 HBM~292 MB
推理负载NPU 利用率20–41%

模型本身仅约 220 万参数 / 8.8 MB(单成员),资源占用非常友好。

六、精度测评

CPU / NPU 一致性(水分子):

运行平台能量 (eV)偏差
CPU 参考-2081.0463—
NPU 实算-2081.04990.004

多分子验证汇总:

分子原子数能量 (eV)Σq
水 H2O3-2081.050.0000
甲烷 CH45-1103.03-0.00001
氨 NH34-1540.060.0000
乙醇 C2H6O9-4220.220.0000
苯 C6H612-6324.140.0000
  • 所有分子电荷守恒误差 ≤ 1e-8;
  • 能量数值与 wB97M-D3 参考量级一致,可用于相对能量比较与结构筛选。

七、注意事项

  • 编译缓存:首次运行必须把 ACL 编译产物写到本地可写盘。若部署在共享存储 且配额紧张,请务必设置 ASCEND_CACHE_PATH 等环境变量,否则会报磁盘配额错误。
  • 首请求较慢:首个推理会做算子 JIT 编译(~80s),建议部署后立即用 water 预热一次。
  • 芯片选择:用 npu-smi info 先看空闲 chip;本适配在 npu:1 上验证通过。
  • 周期体系:当前只覆盖非周期分子;若需 PBC,请改用上游完整版(依赖 nvalchemiops Ewald/DSF)。
  • 集成成员切换:默认加载 member 0。ensemble 参数预留 0–3,切换需重启服务。
  • 元素校验:传入模型不支持的原子序数会得到 422 错误,方便在 API 层拦截脏数据。

八、附

  • 适配说明、算子兼容性分析与特征矩阵见 ADAPTATION_REPORT.md。
  • assets/ 目录包含推理过程中的 NPU 占用原始采集与结果样例。
  • 模型权重许可:MIT。