LAMMPS compute bond/local 命令全解析:逐键统计键长、键能与键动力学量

原创2026-10-14 12:26:001,445 阅读
文章标签:科学计算高性能计算科研

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 键距离矢量 xi⃗−xj⃗\vec{x_i}-\vec{x_j} 的三个分量 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 是键内两原子距离矢量 xi⃗−xj⃗\vec{x_i}-\vec{x_j} 的 (x,y,z)(x,y,z) 分量,原子顺序由键列表决定,对应的原子 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),随后:

需要特别说明的是:对于施加非中心力的键风格(例如 bond_style bpm/rotational),fx/fy/fz 只包含法向力分量的 (x,y,z)(x,y,z) 分量。

键的运动学量:engvib、engrot、engtrans、omega、velvib

其余属性均基于键内两原子相对其质心(COM)的运动计算,全部在 velflag 分支中实现(src/compute_bond_local.cpp):

  • engvib(振动动能):两原子沿键方向的动能之和,即 12m1v12+12m2v22\frac12 m_1 v_1^2 + \frac12 m_2 v_2^2,其中 v1v_1、v2v_2 是扣除质心速度后两原子沿键方向的速度大小。源码中先计算两原子相对质心的位移 delr1/delr2 与速度 delv1/delv2,再与单位键矢量 r12 点积得到平行分量 vpar1/vpar2,最后 engvib = 0.5 * (mass1*vpar1² + mass2*vpar2²)。

  • engrot(转动动能):两原子垂直于键方向的速度所对应的动能之和,12m1v12+12m2v22\frac12 m_1 v_1^2 + \frac12 m_2 v_2^2(v1v_1、v2v_2 为扣除质心速度后的垂直分量)。源码中通过转动惯量 inertia = mass1*|delr1|² + mass2*|delr2|² 与角速度平方 omegasq = vrotsq / |delr1|²(vrotsq 为原子 1 的切向速率平方)计算 engrot = 0.5 * inertia * omegasq。

  • engtrans(质心平动动能):12(m1+m2)Vcm2\frac12(m_1+m_2)V_{cm}^2,VcmV_{cm} 是质心速度大小,源码中 engtrans = 0.5 * masstotal * |vcm|²。

  • omega:两原子绕质心转动的角速度大小,即 sqrt(omegasq)。

  • velvib:两原子沿键长方向彼此靠近的相对速度大小,负值表示相互靠近,正值表示相互远离,源码中 vvib = vpar2 - vpar1。

注意:这三个动能项只是对两原子各自动能之和 12m1v12+12m2v22\frac12 m_1 v_1^2 + \frac12 m_2 v_2^2 的分解,严格满足 总动能 = engvib + engrot + engtrans(其中 v1v_1、v2v_2 是不经质心修正的两原子速度大小)。此外,由于动能是速度的量纲,源码在输出前统一乘以单位换算因子 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 = 初始键长 r0r_0(src/BPM/bond_bpm_spring.cpp)
bond_style bpm/spring/plastic 2 b1 = 初始键长 r0r_0;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 的实现一一对应):

  1. 分组过滤:只有键中两个原子都在指定 compute 组中时,该键才被计入(mask[atom1] & groupbit 与 mask[atom2] & groupbit 同时成立);
  2. 断键排除:通过 bond_style 等命令把键类型置为 0 而断开的键不被计入(if (btype == 0) continue);
  3. 关闭键仍计入:通过 fix shake 或 delete_bonds 将键类型置为负值而关闭的键仍会写入输出,但能量记为 0.0;
  4. newton 处理:当 newton_bond 关闭时,只统计一次 tag[atom1] > tag[atom2] 的键,避免重复计数;
  5. 模板分子支持:对于 atom_style template 这类分子模板体系,键信息从 onemols<a href="https://link.gitcode.com/i/c981586ff5f68acf53bd8c6a0cbafa38" target="_blank">imol] 中读取,键另一端原子通过 tagprev 换算([src/compute_bond_local.cpp);
  6. 跨处理器顺序不保证:随着原子在处理器间迁移,同一 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 三种量做了数值回归校验,可作为验证命令行为正确性的参考基线。

登录后查看全文
lammps