LAMMPS compute bond/local 命令全解析:逐键统计键长、键能与键动力学量
LAMMPS compute bond/local 命令全解析:逐键统计键长、键能与键动力学量
compute bond/local 是 LAMMPS 中面向"单个键相互作用"的 local 数据计算命令,它为系统里每一条键生成一组局部量(键长、键能、键力及其分量、振动/转动/平动动能、角速度等),是结合 dump local、compute reduce、fix ave/histo 做键级统计分析(如键长分布、键能直方图、氢键/断裂键诊断)的核心工具。读完本文,你将掌握该命令的完整语法、每个输出量的物理定义与单位、与 internal 风格变量联动计算任意键长函数的方法,以及如何在真实输入脚本(如 bench/in.rhodo、examples/bpm/pour/in.bpm.pour)中落地使用,并从 src/compute_bond_local.cpp 源码层面理解其实现机制。
命令语法总览
compute ID group-ID bond/local value1 value2 ... keyword args ...
ID、group-ID与其他 compute 命令一致(参见 compute 命令);bond/local是本命令的 style 名称;- 可追加一个或多个
value(不追加任何 value 时命令无意义,源码要求narg >= 4,见 src/compute_bond_local.cpp); value可选值如下表:
| value | 含义 | 输出单位 |
|---|---|---|
dist |
键距离(当前键长) | distance |
dx, dy, dz |
键距离矢量 的三个分量 | distance |
engpot |
键势能 | energy |
force |
键力大小(排斥为正、吸引为负) | force |
fx, fy, fz |
键对原子 i 作用力的分量 | force |
engvib |
键振动动能 | energy |
engrot |
键转动动能 | energy |
engtrans |
键质心平动动能 | energy |
omega |
键角速度大小 | velocity/distance |
velvib |
沿键长方向的相对振动速度 | velocity |
v_name |
名称为 name 的 equal-style 变量(见下文 set 关键字) |
随变量公式 |
bN |
键风格定义的第 N 个专属量 | 随键风格 |
- 可追加零个或多个
keyword/args对,当前唯一支持的 keyword 是set:
set args = dist name
其中 dist 是目前唯一允许的 arg,name 是被赋值键距离的变量名。该变量必须是 internal-style 变量(因为它由本命令直接改写值)。
典型用法示例
compute 1 all bond/local engpot
compute 1 all bond/local dist engpot force
compute 1 all bond/local dist fx fy fz b1 b2
compute 1 all bond/local dist v_distsq set dist d
第一句只输出每条键的势能(生成 local vector);第二句同时输出键长、键能、键力(local array);第三句把键长分量与力分量、以及 BPM 键风格的专属量 b1、b2 一起输出;第四句通过变量 v_distsq 计算键长的自定义函数(此处为键长平方)。
在源码 src/compute_bond_local.cpp 中,每个 value 关键字都会被逐一解析并映射到内部的枚举值(DIST、DX、DY、DZ、ENGVIB、OMEGA、ENGTRANS、ENGVIB、ENGROT、ENGPOT、FORCE、FX、FY、FZ、VARIABLE、BN),bN 通过正则 ^b\d+$ 匹配并解析出下标(bindex<a href="https://link.gitcode.com/i/c49dea5a659b3743a37d96c17238e290" target="_blank">n] = n-1,即 b1 对应下标 0)。命令解析完毕后,会根据所选值自动决定两个内部标志:需要调用 bond->single() 的 singleflag(涉及 engpot/force/fx/fy/fz/bN),以及需要用到原子速度的 velflag(涉及 velvib/omega/engtrans/engvib/engrot),见 [src/compute_bond_local.cpp。
各输出量的物理定义
所有输出量都针对键中的一对原子计算,无论这两个原子是构成简单的双原子分子,还是属于某个更大的分子。
键长与距离分量:dist、dx/dy/dz
dist 是键当前的长度。dx、dy、dz 是键内两原子距离矢量 的 分量,原子顺序由键列表决定,对应的原子 ID 可用 compute property/local 命令输出(batom1、batom2)以做一一对应。
版本行为变化(12Jun2025):
dx、dy、dz的符号不再由成键原子的 ID 大小决定,而是由它们在键列表中的顺序决定,从而与fx、fy、fz(作用于第一个原子 i)保持符号一致。这一约定在源码 src/compute_bond_local.cpp 中有对应实现:距离矢量按x[atom1] - x[atom2]计算,并经domain->minimum_image()施加最小镜像约定。
键势能与键力:engpot、force、fx/fy/fz
engpot 是键在当前分离距离下的势能。force 是键内两原子间作用力的大小,正值表示排斥力、负值表示吸引力。fx、fy、fz 是键中第一个原子 i 因第二个原子 j 所受作用力的三个分量,数学上等于 force 乘以由 dx/dy/dz 构成的单位矢量。
在源码实现中,engpot 与键力标量通过 bond->single(btype, rsq, atom1, atom2, fbond) 一次调用获得(src/compute_bond_local.cpp),随后:
FORCE输出sqrt(rsq) * fbond;FX/FY/FZ分别输出dx * fbond、dy * fbond、dz * fbond(src/compute_bond_local.cpp)。
需要特别说明的是:对于施加非中心力的键风格(例如 bond_style bpm/rotational),fx/fy/fz 只包含法向力分量的 分量。
键的运动学量:engvib、engrot、engtrans、omega、velvib
其余属性均基于键内两原子相对其质心(COM)的运动计算,全部在 velflag 分支中实现(src/compute_bond_local.cpp):
-
engvib(振动动能):两原子沿键方向的动能之和,即 ,其中 、 是扣除质心速度后两原子沿键方向的速度大小。源码中先计算两原子相对质心的位移delr1/delr2与速度delv1/delv2,再与单位键矢量r12点积得到平行分量vpar1/vpar2,最后engvib = 0.5 * (mass1*vpar1² + mass2*vpar2²)。 -
engrot(转动动能):两原子垂直于键方向的速度所对应的动能之和,(、 为扣除质心速度后的垂直分量)。源码中通过转动惯量inertia = mass1*|delr1|² + mass2*|delr2|²与角速度平方omegasq = vrotsq / |delr1|²(vrotsq为原子 1 的切向速率平方)计算engrot = 0.5 * inertia * omegasq。 -
engtrans(质心平动动能):, 是质心速度大小,源码中engtrans = 0.5 * masstotal * |vcm|²。 -
omega:两原子绕质心转动的角速度大小,即sqrt(omegasq)。 -
velvib:两原子沿键长方向彼此靠近的相对速度大小,负值表示相互靠近,正值表示相互远离,源码中vvib = vpar2 - vpar1。
注意:这三个动能项只是对两原子各自动能之和 的分解,严格满足 总动能 = engvib + engrot + engtrans(其中 、 是不经质心修正的两原子速度大小)。此外,由于动能是速度的量纲,源码在输出前统一乘以单位换算因子 mvv2e = force->mvv2e,使得在 real/metal 等非 reduced 单位制下能量数值正确(src/compute_bond_local.cpp)。
用变量计算键长的任意函数:v_name 与 set 组合
v_name 必须与 set 关键字配合使用:set dist name 指定的 name 是一个 internal-style 变量,命令会在每条键上直接改写该变量的值为当前键长;而 v_name 中的 name 是一个 equal-style 变量,其公式可以引用前者,从而计算出键长的任意函数。
- 若
set指定的 internal 变量在输入脚本中未定义,命令会自动创建(源码 src/compute_bond_local.cpp 调用input->variable->internal_create(dstr, 0.0)); - 每条键计算时先执行
internal_set(dvar, sqrt(rsq))写入当前键长,再逐值求 equal-style 变量(src/compute_bond_local.cpp、src/compute_bond_local.cpp); - 若使用了
v_name却没有set,或set使用了错误的变量类型,命令会在初始化时报错。internal-style 与 equal-style 变量的完整说明见 variable 命令。
bench/in.rhodo(bench/in.rhodo)是一个典型的分子体系输入脚本(rhodopsin 模型,atom_style full + bond_style harmonic),可以直接在其基础上追加以下命令,统计系统每条键的键长平方:
variable dsq equal v_d*v_d
compute 1 all property/local batom1 batom2 btype
compute 2 all bond/local engpot dist v_dsq set dist d
dump 1 all local 100 tmp.dump c_1[*] c_2[*]
compute 3 all reduce ave c_2[*] inputs local
thermo_style custom step temp press c_3[*]
fix 10 all ave/histo 10 10 100 0 6 20 c_2[3] mode vector file tmp.histo
其中 dump local 会逐键输出能量、键长与键长平方;thermo_style 借助 compute reduce 在热力学输出中打印这些量的平均值;fix ave/histo(fix ave/histo 文档)则对键长平方做直方图统计并写入 tmp.histo 文件。若只想看键长而非键长平方,可把 v_dsq 换成 v_d。
键风格专属量:b1 … bN
不同的键风格可以在 single() 函数中额外计算若干专属量,通过 b1 到 bN 访问,N 由键风格定义。大多数键风格不定义任何额外量,即 N=0;典型例外是 BPM 键风格(可断裂键模型),它们会存储两粒子之间的参考状态。
源码层面,每个键风格通过基类 Bond 的两个成员对外暴露这些量:int single_extra(额外单键量个数)与 double *svector(额外量数值数组),见 src/bond.h。compute bond/local 读取 bN 时直接取值 bond->svector<a href="https://link.gitcode.com/i/8568bb93c78f9542dd1b5040bbda0855" target="_blank">bindex[n]]([src/compute_bond_local.cpp),并在初始化时校验 bindex[i] < force->bond->single_extra,越界即报错。
各 BPM 风格定义的专属量举例(均可从源码确认):
| 键风格 | N | b1…bN 含义 |
|---|---|---|
| bond_style bpm/rotational | 7 | b1 = 参考键长 ri_norm;b2/b3/b4 = 参考状态下的键矢量分量;b5/b6/b7 = 法向接触力分量(src/BPM/bond_bpm_rotational.cpp) |
| bond_style bpm/spring | 1 | b1 = 初始键长 (src/BPM/bond_bpm_spring.cpp) |
| bond_style bpm/spring/plastic | 2 | b1 = 初始键长 ;b2 = 塑性变形后的参考键长 (1.0+ep)*r0(src/BPM/bond_bpm_spring_plastic.cpp) |
| bond_style bpm/peri | 1 | b1 = 参考键长(src/BPM/bond_bpm_peri.cpp) |
在真实 BPM 示例脚本 examples/bpm/pour/in.bpm.pour 中,就有如下组合用法(配 bond_style bpm/rotational):
compute bond_properties all bond/local dist b1
dump 2 all local 500 bondDump c_bond_ids[*] c_bond_properties[*]
dump_modify 2 colname 1 "id1" colname 2 "id2" colname 3 "r" colname 4 "r0"
这里 b1 就是键的参考长度 r0,与当前键长 dist 一起输出,可直接用于分析颗粒键的形变。
与 hybrid 键风格的配合
当与 bond_style hybrid 配合使用 bN 时,输出的是实际计算该键相互作用(依据键类型分派)的子风格的第 N 个量;若该子风格没有定义 bN,则输出 0.0。允许的最大 N 是所有子风格中额外量个数的最大值——这正是 BondHybrid::init_svector() 中 single_extra = MAX(single_extra, styles<a href="https://link.gitcode.com/i/3021b746a66c979bbdf72c8a6acae9ad" target="_blank">m]->single_extra) 的语义([src/bond_hybrid.cpp),且未定义该量的子风格会被 copy_svector() 清零(src/bond_hybrid.cpp)。
local 数据的产生规则与并行行为
该命令生成的 local 数据通过遍历"本处理器拥有的原子及其键"得到,具体规则(与 src/compute_bond_local.cpp 的实现一一对应):
- 分组过滤:只有键中两个原子都在指定 compute 组中时,该键才被计入(
mask[atom1] & groupbit与mask[atom2] & groupbit同时成立); - 断键排除:通过 bond_style 等命令把键类型置为 0 而断开的键不被计入(
if (btype == 0) continue); - 关闭键仍计入:通过 fix shake 或 delete_bonds 将键类型置为负值而关闭的键仍会写入输出,但能量记为 0.0;
- newton 处理:当
newton_bond关闭时,只统计一次tag[atom1] > tag[atom2]的键,避免重复计数; - 模板分子支持:对于
atom_style template这类分子模板体系,键信息从onemols<a href="https://link.gitcode.com/i/c981586ff5f68acf53bd8c6a0cbafa38" target="_blank">imol]中读取,键另一端原子通过tagprev换算([src/compute_bond_local.cpp); - 跨处理器顺序不保证:随着原子在处理器间迁移,同一 local vector/array 在不同时间步之间没有一致的条目顺序;唯一保证是"同一时间步内,由不同 compute 命令生成的 local 数据顺序一致",因此可以与 compute property/local 的输出在
dump local中安全对齐。
一个典型的对齐示例:
compute 1 all property/local btype batom1 batom2
compute 2 all bond/local dist engpot
dump 1 all local 1000 tmp.dump index c_1[*] c_2[*]
这样每条 dump 记录都同时携带键类型、两端原子 ID、键长与键能,便于后处理识别具体是哪条键的数据。
输出格式与单位
- 只指定一个 value 时生成 local vector;指定两个及以上 value 时生成 local array,列数等于 value 个数,行数等于系统键数(受分组过滤影响)。源码中通过
size_local_cols区分两种形态,数据存储在vector_local/array_local中,并由reallocate()按DELTA = 10000的步长动态扩容(src/compute_bond_local.cpp、src/compute_bond_local.cpp)。 - 任何使用 local 值的命令(
dump local、compute reduce、fix ave/histo等)都可以消费这些数据,LAMMPS 输出选项的总览见 Howto output。 - 单位遵循 units 设置:
dist为距离单位,velvib为速度单位,omega为速度/距离单位,engtrans/engvib/engrot/engpot为能量单位,force为力单位。
限制、相关命令与默认值
- 限制:无(
Restrictions: none)。但注意两点前置条件:使用该命令的体系必须允许键存在,否则源码直接报错"Compute bond/local used when bonds are not allowed"(src/compute_bond_local.cpp);初始化时必须已定义键风格,否则报错"No bond style is defined for compute bond/local"(src/compute_bond_local.cpp)。 - 相关命令:dump local、compute property/local。
- 默认值:无。
官方单元测试 unittest/force-styles/tests/compute-bond_local.yaml 在 atom full 与 compute bond/local 前置条件下,对 dist engpot force 三种量做了数值回归校验,可作为验证命令行为正确性的参考基线。