LAMMPS angle_style cross 详解:键长-角度耦合势的实现、参数设置与源码解析

原创2026-10-14 11:21:051,668 阅读
文章标签:科学计算高性能计算科研

LAMMPS angle_style cross 详解:键长-角度耦合势的实现、参数设置与源码解析

cross 是 LAMMPS 中一种特殊的角势风格(angle style),它将同一个弯折(bend)上两条键的拉伸与键角偏差以交叉耦合的方式耦合进能量表达式,主要用于金属有机框架(MOF)等体系的力场计算。本篇以官方命令文档 doc/src/angle_cross.rst 为主线,完整讲解 angle_style cross 的语法、势函数公式、angle_coeff 六个系数的单位与物理含义,并结合 src/YAFF/angle_cross.cpp 等仓库源码剖析其力与能量的实际计算方式、角度单位换算、restart/data 文件读写机制,以及加速变体 cross/kk、cross/omp 的使用前提。

命令语法与基本用法

angle_style cross 命令本身不接收任何额外参数:

angle_style cross

在指定角势风格后,必须通过 angle_coeff 命令(或经由 read_data / read_restart 读取的数据文件、重启文件)为每个角类型定义完整的一组系数。官方文档给出的示例如下:

angle_style cross
angle_coeff 1 200.0 100.0 100.0 1.25 1.25 107.0

其中 angle_coeff 后的第一个数字 1 是角类型编号,后续依次是 K_SS、K_BS0、K_BS1、r_{12,0}、r_{32,0}、θ0 共 6 个数值。与 LAMMPS 其他 angle_coeff 支持类型区间写法不同,cross 风格的系数解析在源码中被固定为"一次指定一个类型的 7 个参数(类型号 + 6 个系数)",见 src/YAFF/angle_cross.cpp 中的 coeff() 函数——当参数个数不等于 7 时会直接报错 Incorrect args for angle coefficients。

势函数公式与系数物理含义

cross 角势的核心是"键拉伸-键拉伸"项与"键拉伸-角度拉伸"项的交叉耦合,其能量表达式为:

E = K_SS · (r₁₂ − r₁₂,₀)(r₃₂ − r₃₂,₀) + K_BS0 · (r₁₂ − r₁₂,₀)(θ − θ₀) + K_BS1 · (r₃₂ − r₃₂,₀)(θ − θ₀)

其中:

  • r_{12,0}:原子 1 与中心原子 2 之间键的平衡(rest)键长;
  • r_{32,0}:原子 3 与中心原子 2 之间键的平衡键长;
  • θ₀:平衡键角;
  • K_SS:键拉伸-键拉伸耦合项的力常数;
  • K_BS0、K_BS1:分别对应第一条键(1-2)与第二条键(3-2)的键拉伸-角度拉伸耦合力常数。

每个角类型需定义的系数及其单位为:

系数 物理含义 单位
K_SS 键拉伸-键拉伸项力常数 energy/distance²
K_BS0 键拉伸(1-2)-角度拉伸项力常数 energy/distance
K_BS1 键拉伸(3-2)-角度拉伸项力常数 energy/distance
r_{12,0} 1-2 键平衡键长 distance
r_{32,0} 3-2 键平衡键长 distance
θ₀ 平衡键角 degrees(度)

需要注意一个重要的单位细节:θ₀ 以度输入,但 LAMMPS 内部会将其转换为弧度存储,因此 K_BS0 与 K_BS1 的实际量纲是 energy/distance per radian(每弧度),而不是文档表中字面的 energy/distance。这一点在源码中有直接体现:coeff() 中执行 theta0<a href="https://link.gitcode.com/i/d05114dc34ced08b2ce8bd88dfa277a3" target="_blank">i] = theta0_one * MY_PI / 180.0 完成度到弧度的换算(见 [src/YAFF/angle_cross.cpp)。相应地,写出 data 文件时又会乘回 180/π 还原为度(write_data(),src/YAFF/angle_cross.cpp),保证 data 文件中 Angle Coeffs 段记录的 theta0 仍是以度为单位。

力与能量的计算流程(源码级剖析)

从 src/YAFF/angle_cross.cpp 的 compute() 函数(L64-L200)可以看到该角势的实际计算逻辑:

  1. 几何量求取:对每个角度三元组 (i1, i2, i3),先算出键向量 delx1/dely1/delz1(原子 1 相对原子 2)与 delx2/dely2/delz2(原子 3 相对原子 2)及其键长 r1、r2;再通过点积与范数归一化得到 cos θ,并用 s = 1/sin θ 作为角度偏导的放大因子。为防止 0 除,代码对 s 施加了 SMALL = 0.001 的下限保护(L36、L117),即当键角极端接近 0° 或 180° 时会出现数值裁剪。

  2. 键-键项:令 dr1 = r1 - r00[type]、dr2 = r2 - r01[type],则能量贡献为 K_SS·dr1·dr2;作用在原子 1、3 上的力分别为 f1 = -(K_SS·dr2/r1)·Δx1、f3 = -(K_SS·dr1/r2)·Δx2,方向沿键方向。

  3. 键-角项:令 dtheta = acos(c) - theta0<a href="https://link.gitcode.com/i/b3d97adbfdf80721565cb362299c6741" target="_blank">type],能量贡献为 K_BS0·dr1·dtheta + K_BS1·dr2·dtheta。力的推导对角度偏导使用了 s = 1/sin θ 因子,并按 aa11 = aa1·c/rsq1、aa12 = -aa1/(r1·r2) 等系数分别分解到两个键方向上,最终按牛顿第三定律把 f1 + f3 的反作用施加在中心原子 i2 上([L179-L195)。注意该实现遵循 newton_bond 开关:当 newton_bond off 时,只有本进程拥有的原子(i < nlocal)会收到力,以支持 bond 的 1-2 拆分计算模式。

  4. 能量统计:每个角度的能量通过 ev_tally() 完成能量与应力张量(virial)的累加,因此 thermo_style 输出的 Ettyl 和压力都包含 cross 角势的贡献。

此外,compute() 中还有一段值得注意的实现事实:源文件中 b1/b2 两项的声明位置在逻辑上属于键-角项的辅助量(L164-L165),与 vx/vy/vz 系列分量共同构成完整的解析力表达式。

与 compute pair 的对接:single() 与 extract()

该风格还实现了 single(type, i1, i2, i3) 接口(src/YAFF/angle_cross.cpp),即直接返回单个角度的总能量 K_SS·dr1·dr2 + K_BS0·dr1·dtheta + K_BS1·dr2·dtheta,因此可以与 compute pair 风格配合,通过 compute pair id cross i1 i2 i3 之类的用法查询指定角度的能量——这是验证力场参数与调试时的实用手段。single() 内部使用了 domain->minimum_image() 做最小镜像处理,而常规 compute() 依赖邻居列表保证几何正确。

另外,extract() 接口(src/YAFF/angle_cross.cpp)暴露了 r00、r01、kss、kbs0、kbs1、theta0 六个内部数组指针,可被 compute reduce 等的 property 机制访问;单元测试正是利用这一点校验系数是否正确读入(见下文测试小节中的 extract 段)。

系数持久化:restart 与 data 文件

cross 风格的六组系数会随模拟状态完整持久化:

  • restart 写/读:write_restart() 按 kss → kbs0 → kbs1 → r00 → r01 → theta0 的固定顺序以二进制 double 写出全部类型;read_restart() 由进程 0 读入后通过 MPI_Bcast 广播到所有进程(src/YAFF/angle_cross.cpp)。因此用 read_restart 恢复模拟时无需重新写 angle_coeff。
  • data 文件:write_data() 将系数以 类型号 K_SS K_BS0 K_BS1 r00 r01 theta0(度) 的文本行写入 data 文件的 Angle Coeffs 段,供 read_data 使用。

加速变体:cross/kk 与 cross/omp

文档标注的 Accelerator Variants 为 cross/kk 与 cross/omp,它们是同一风格的硬件加速版本,参数与结果(除舍入误差外)与基础风格一致(见 doc/src/accel_styles.rst):

加速风格仅在 LAMMPS 以相应包(OPENMP、KOKKOS)编译时才可用。在输入脚本中可显式写 angle_style cross/kk,也可通过命令行开关 -suffix 或输入脚本中的 suffix 命令批量切换(机制见 doc/src/accel_styles.rst)。

使用限制与适用范围

  • 该角势只能在使用 YAFF 包编译的 LAMMPS 中可用(基础风格);cross/omp、cross/kk 则分别要求 OPENMP、KOKKOS 包。关于如何启用包,参见文档中的 Build package 页面。
  • YAFF 包本身是为使用 QuickFF 方法生成的力场而设计的,面向金属有机框架(MOF)模拟,cross 角势正是 QuickFF 力场中键-角耦合项的体现,包说明见 src/YAFF/README。
  • 从实现看,cross 没有截断半径(cutoff)或 shift/force 等修饰选项,angle_coeff 参数个数固定为 7,任何多余或缺失都会触发致命错误。
  • 文档标注其 Default 为 none,即不指定时不存在默认系数,未定义系数就使用对应角类型会因 setflag 未置位而无法工作。

单元测试:如何在仓库中验证 cross 风格

仓库提供了针对 cross 角势的基准测试,是理解该风格行为的良好参照:

angle_style cross
angle_coeff 1 200.0  80.0  75.0 0.95 1.30 107.0
angle_coeff 2 540.0 120.0 125.0 1.25 1.15 109.5
angle_coeff 3 100.0 150.0 120.0 1.45 1.35  98.2
angle_coeff 4 250.0  90.0 110.0 1.05 1.20  99.9

该 yaml 还记录了平衡后的能量(equilibrium)、初态/运行态能量、应力与逐原子力等参考值(如 init_energy: -138.93227715361755、run_energy: -143.17285626124033),并带有 epsilon: 2.5e-13 的容差,可用于跨平台复现校验。

  • 共享输入脚本:unittest/force-styles/tests/in.fourmol 用变量占位的方式统一了 atom_style full、newton pair/bond、special_bonds 与 read_data 的设置,各角势测试通过覆盖 angle_style 变量复用同一数据文件(data.fourmol)。
  • 该测试的 extract 段明确要求能读取 r00、r01、kss、kbs0、kbs1、theta0 六项系数,与 AngleCross::extract() 暴露的键名一一对应。

小结与相关命令

要素 说明
命令 angle_style cross(无参数)
加速变体 cross/kk(KOKKOS 包)、cross/omp(OPENMP 包)
系数来源 angle_coeff(每行 7 个参数)、read_data、read_restart
能量项 键-键交叉项 + 两组键-角交叉项
角度单位 输入为度,内部换算为弧度存储
源码 src/YAFF/angle_cross.cpp、src/OPENMP/angle_cross_omp.cpp、src/KOKKOS/angle_cross_kokkos.cpp
测试 unittest/force-styles/tests/angle-cross.yaml
相关命令 angle_coeff

与常规角势(如 harmonic 只含角度项、cosine 只含角度周期项)不同,cross 风格通过 K_SS、K_BS0、K_BS1 三个交叉系数把键长偏差与角度偏差直接耦合,适合描述 MOF 骨架中"键长变化影响键角响应"的弹性行为;如果你需要为 QuickFF 类力场配置 MOF 模拟,或想验证键-角耦合项的解析力实现,可从上文给出的源码与测试文件入手深入阅读。

登录后查看全文
lammps