势模型返回一个标量和一个数组,并不意味着结果已经具备明确科研含义。还需要知道它们对应的原子、几何、电子态、单位与能量参照。本指南面向接收模型输出或准备审核材料的研究者,不按缺乏共同条件的性能数字给模型排名。
两个项目分别提供什么
SpookyNet 是带电子态输入和非局域贡献的势模型参考实现,可配置排斥、静电与色散项。原论文 说明了设计动机。接口允许输入电荷或自旋相关信息,不代表具体权重覆盖全部电荷态与反应。
TorchMD-Net 是训练和使用神经网络势的框架。本次查看的 main README 重点列出 TensorNet/TensorNet2,将旧 ET、Transformer、GN 标为 deprecated。2026-10-18 的 PyPI 元数据 为 3.0.3、Python >=3.10;main 源码行为仍需与实际安装版核对。两个项目的组织和架构不同,输出不能直接当作统一基准结果。
先建立输入契约
逐构型保存原子序数、顺序、坐标、长度单位、分子/批次归属及适用时的周期晶胞。先检查非有限坐标、原子重叠、未覆盖元素和边界条件,再解读能量。
SpookyNet 的核心输入文档 使用 Z、R、每体系总电荷 Q、磁矩编码 S 及邻居信息。文档约定单重态 S=0、二重态 S=1、三重态 S=2,不能未经换算直接代入量子自旋值或多重度。ASE 计算器 的 charge、magmom 会传入模型。默认中性/单重态不等于软件识别出了分子的真实电子态。
TorchMD-Net 的模型源码 接收 z、pos、batch 等输入。可选参数存在,不证明所有架构或权重以相同方式使用它;需核查表示网络、输出模块和训练配置。
把输出当作有语义的契约
| 输出 | 必须确定的含义 | 常见错误 |
|---|---|---|
| 每体系标量 | 目标定义、聚合方式与能量参照 | 把任意标量叫作总能量 |
| 力数组 | 原子对应、负梯度约定、能量/长度单位 | 原子重排或符号错误 |
| 电荷/偶极 | 定义、参照与训练证据 | 当作唯一可测的原子电荷 |
| 集成离散程度 | 参与模型和统计方式 | 当作已校准误差界限 |
能量势的力满足 F = -∂E/∂R。SpookyNet 物理项假设 Å 与 eV;源码提醒,换单位需一致修改相关常数。在该约定下力为 eV/Å,不能只给另一单位训练出的数组换标签。
本次查看的 TorchMD-Net 实现中,derivative=True 返回标量及其坐标负导数;关闭导数时,代码返回空 tensor,而 docstring 仍提及 None。应检查安装版,不能依赖旧示例或数组真值判断。如果所选标量不是能量,其导数也不能称为物理力。原子参照、先验和目标缩放都需追溯。
不虚构数值的审阅练习
为一份输出建立记录:构型 ID、坐标文件哈希、权重哈希、代码版本、目标和单位、原子顺序、总电荷/电子态约定、能量参照、原始输出形状、失败状态。选择公开、在域内且有明确参照方法的几何。这是建议工作表,不是已执行示例,Code status 为 不适用。
先查形状、有限值和原子对齐。对能量模型,可设计有限差分核对:用 -[E(R+h)-E(R-h)]/(2h) 比较某坐标上的力。主动选择多个位移与数值精度,避开病态构型或不连续的邻居列表变化。平移、旋转检查还要一致变换向量。这些只是内部一致性检查;一个不准确的势能面也可能通过。
用正确参照解释误差
比较前匹配参考方法、电子态、元素组成和能量约定。原子参照偏移、总能与每原子能差异可能主导表面上的绝对误差。力 MAE 应写清平均笛卡尔分量还是每原子向量范数,两者不是同一指标。按相关构象或轨迹分组,避免评价集合间泄漏。
同时报告逐构型误差、分组误差和计算失败。畸变结构、陌生电荷态、训练域外化学应单列。平衡几何上的平均误差好,不等于动力学稳定或断键可信。集成分歧可辅助筛查,但小分歧不能排除共同系统误差。实验观测还需匹配条件和不确定性分析。
版本、许可与验证层次
SpookyNet 和 TorchMD-Net 代码声明 MIT,权重与训练数据仍须单独核查。TorchMD-Net 当前 README 说明旧 TensorNet 权重的兼容重映射;应保留原文件并查看所选发行版迁移说明,不宣称任意版本二进制或数值兼容。
本轮没有执行推断、有限差分、电子结构参照或动力学。来源核对支持接口陈述,审阅程序属于编辑建议。运行成功、导数一致、参考精度与实验验证应分别报告。具体执行和材料模型广泛选型,可继续查 ASE 与 MLIP 指南。
站内资源、指南与工作流
SpookyNet · TorchMD-Net · ASE
ASE 与机器学习势:单位、优化及验证 · 机器学习原子间势选型:MACE、SevenNet、CHGNet 与 MatGL · QM9 分子性质预测:如何正确评估
来源与证据状态
来源查阅日期:2026-10-18。官方资料支持能力与 API 陈述;审计与验收流程属于编辑建议,不代表科学验证或实测性能。