LAMMPS compute improper/local 命令详解:逐键合统计不合理二面角 χ 与局部数据输出

原创2026-10-14 18:22:481,641 阅读
文章标签:科学计算高性能计算科研

LAMMPS compute improper/local 命令详解:逐键合统计不合理二面角 χ 与局部数据输出

compute improper/local 是 LAMMPS 中用于逐个遍历系统中每一条 improper(不合理相互作用)拓扑、计算其"不合理角 χ"并以**局部数据(local vector/array)**形式提供给下游输出命令使用的核心 compute 风格。本文以 compute_improper_local.rst 官方文档为主线,结合 compute_improper_local.cpp 源码与 compute-improper_local.yaml 单元测试,完整讲解该命令的语法、计算语义、底层几何实现,以及如何与 compute property/local、dump local 配合导出每条 improper 的原子拓扑与角度数据。

命令语法与参数

compute ID group-ID improper/local value1 value2 ...
  • ID、group-ID:与其他 compute 命令一致,详见 compute 命令。group-ID 决定哪些原子参与统计,all 表示全部原子。
  • improper/local:本 compute 的风格名称。
  • value:目前只支持一个关键字 chi,表示"逐个输出 improper 角"。

用法示例:

compute 1 all improper/local chi

从源码(compute_improper_local.cpp)可以看到,参数解析非常严格:

if (narg < 4) utils::missing_cmd_args(FLERR, "compute improper/local", error);
...
for (int iarg = 3; iarg < narg; iarg++) {
  if (strcmp(arg[iarg], "chi") == 0)
    cflag = nvalues++;
  else
    error->all(FLERR, iarg, "Unknown compute improper/local keyword {}", arg[iarg]);
}

即:命令必须携带至少一个关键字(因此 narg >= 4),且只接受 chi,任何拼写错误都会直接以 Unknown compute improper/local keyword 报错终止运行。这是典型的 LAMMPS 参数解析风格——宁可报错,也不容忍静默忽略。

计算语义:χ 是什么,怎么数出来的

χ 的物理定义

文档明确指出,chi 输出的就是各 improper 风格文档中定义的不合理角。以最常用的 improper_style harmonic 为例:若 improper 四元组在数据文件中按 I,J,K,L 排序,则 χ 是平面 I-J-K 与平面 J-K-L 之间的二面夹角;等价地理解,J、K、L 三个原子构成一个平面,I 原子在该平面之上/之下,χ 度量了 I 偏离该平面(out-of-plane)的程度。其势能表达式为

E = K (χ - χ0)^2

其中 K 为力常数(已含 1/2 因子),χ0 为平衡角(以度为单位指定,内部换算为弧度)。注意 improper 与二面角(dihedral)的本质区别:dihedral 中 4 个原子以线性链 I-J-K-L 相连,而 improper 中通常是 I 与 J、K、L 三者分别成键(I-J、I-K、I-L),构成一个"伞形/金字塔形"的平面外振动拓扑。

chi 的数值以度(degrees)为单位输出。

数据量的确定规则

该 compute 生成的局部数据条数,是所有处理器合计的 improper 总数,但受 group 过滤约束:一条 improper 只有当其 4 个原子全部位于指定 group 中时,才会被计入。这与键长(bond/local)、键角(angle/local)、二面角(dihedral/local)的过滤逻辑保持一致。

源码中的计数逻辑(compute_improper_local.cpp)分两遍执行:

  1. 第一遍(flag=0)只计数:遍历本进程拥有的原子(atom->nlocal),对每个原子遍历其 num_improper 条 improper 拓扑;
  2. 第二遍(flag=1)计数并计算:在计数的基础上同时填充 χ 值。

关键的过滤判断为:

if (!(mask[atom2] & groupbit)) continue;                    // 中心原子须在 group
...
if (tag[atom2] != improper_atom2[atom2][i]) continue;       // 仅当 atom2 是该 improper 的存储原子
...
if (atom1 < 0 || !(mask[atom1] & groupbit)) continue;       // 其余 3 个原子须已知且在 group
if (atom3 < 0 || !(mask[atom3] & groupbit)) continue;
if (atom4 < 0 || !(mask[atom4] & groupbit)) continue;

需要特别说明的是 "only count if 2nd atom is the one storing the improper"(仅当第 2 个原子是存储该 improper 的原子时才计数):LAMMPS 中每条 improper 拓扑只归属于 4 个原子中的某一个(这里是 atom2)存储,因此该判断确保每条 improper 在并行环境下恰好被计数一次,不会因原子在进程间的镜像拷贝而重复统计。这是保证"全局总条数 = 系统 improper 总数"的关键。

对模板分子(template molecules)的支持

除了常规的分子体系(atom->molecular == Atom::MOLECULAR),源码还处理了模板分子(template)场景:当原子属于某个 onemols[imol] 模板分子时,improper 拓扑从模板定义中读取,并通过 tagprev = tag[atom2] - iatom - 1 做标签偏移换算,将模板内的相对原子索引映射为全局原子标签,再通过 atom->map() 查回本进程内的局部索引。因此该 compute 在 molecule 模板体系下同样可用。

底层几何实现:χ 的向量计算

chi 的数值并非来自 improper 势函数,而是 compute 自身基于原子坐标独立计算的(compute_improper_local.cpp)。计算流程如下:

  1. 构造三个向量:

    • vb1 = x[atom1] - x[atom2](I−J)
    • vb2 = x[atom3] - x[atom2](K−J)
    • vb3 = x[atom4] - x[atom3](L−K)

    每个向量都经过 domain->minimum_image() 处理,以保证在周期性边界条件下使用最近镜像(minimum image convention),从而正确处理跨边界的 improper。

  2. 依次计算三对向量之间的余弦值:

    • c0:vb1 与 vb3 之间的夹角余弦
    • c1:vb1 与 vb2 之间的夹角余弦
    • c2:−vb3 与 vb2 之间的夹角余弦
  3. 由球面三角关系合成 χ 的余弦 c = (c1*c2 + c0) * sqrt(s1*s2),其中 s1 = 1/(1-c1²)、s2 = 1/(1-c2²) 是对退化构型的正则化处理(当 1-c² 小于常量 SMALL = 0.001 时被强制钳制,避免除零)。

  4. 对合成余弦做 ±1 钳制(if (c > 1.0) c = 1.0; if (c < -1.0) c = -1.0;)以消除浮点误差,最后:

if (cbuf) cbuf[n] = 180.0 * acos(c) / MY_PI;

即通过反余弦换算为角度制并写入局部数组。这套算法与 improper_style harmonic 势能中的 χ 定义严格一致,因此 compute improper/local chi 输出的角度可以直接用于校验势能计算、检查构型是否偏离平衡角 χ0。

内存管理

源码采用增量式内存分配策略(compute_improper_local.cpp):nmax 每次按 DELTA = 10000 条递增,不足时 reallocate() 重新分配;单个关键字时维护一维 vector_local,多关键字时维护二维 array_local。memory_usage() 返回 nmax * nvalues * sizeof(double),供 run 结束时的内存统计使用。

实战:与 property/local 和 dump local 组合导出逐条数据

compute improper/local 单独只能输出角度,无法告诉用户"这条角度属于哪几个原子、什么类型"。官方文档给出的标准做法是与 compute property/local 联用:后者支持 iatom1 iatom2 iatom3 iatom4 itype 等 improper 属性(分别存储 4 个原子 ID 与 improper 类型),两者按相同规则(同一 improper 拓扑、同样的 group 过滤)生成行数一致且行序一致的局部数据,因此可以逐行合并输出:

compute 1 all property/local itype iatom1 iatom2 iatom3 iatom4
compute 2 all improper/local chi
dump 1 all local 1000 tmp.dump index c_1[1] c_1[2] c_1[3] c_1[4] c_1[5] c_2[1]

运行后 tmp.dump 的每一行对应系统中的一个 improper,共 6 列:

列 来源 含义
1 index 该 improper 的全局序号(1 到 N)
2 c_1[1] improper 类型(itype)
3–6 c_1[2]..c_1[5] 4 个原子的标签(iatom1..iatom4)
7 c_2[1] 该 improper 的角度 χ(度)

关于 dump local 的细节(dump.rst、dump.rst):

  • local 风格 dump 把 compute/fix 产生的局部向量/数组逐行写入文件;index 属性为每行生成 1 到 N 的编号;
  • c_ID 输出局部向量,c_ID[I] 输出局部数组的第 I 列(I 支持通配符 *);
  • 输出内容来自各进程当前拥有的原子,因此原子在进程间迁移时,不同快照中同一 improper 的 index 序号不保证一致——但同一时刻由其他 compute(如 property/local)生成的局部数据行序与行数一致,可安全合并;
  • dump local 甚至可以直接生成可粘贴回数据文件的拓扑信息(read_data 兼容),方便构型检查与数据回写。

更普遍地,LAMMPS 的四类输出数据(global / per-atom / local / per-grid,见 Howto_output)中,局部数据既可被 dump local 落盘,也可被 compute reduce 归约或 fix ave/histo 统计直方图。例如,用 compute reduce ave c_2[1] 可以快速得到体系全部 improper 角的平均值,用于监测整体构型偏离程度。

行序一致性:并行环境下的使用前提

源码注释与文档共同强调了一个重要的并行语义:由于原子在各时间步之间会在进程间迁移,局部向量/数组中的条目顺序在不同时间步之间没有一致性保证;唯一能保证的是"同一时间步内,由不同 compute 命令生成的局部数据行序一致"。这正是 property/local 与 improper/local 可以安全逐行合并的根本原因,也是使用 dump local 时必须将 index、拓扑属性与物理量放在同一个 dump 命令中的原因——任何跨快照的"按序号匹配"都可能张冠李戴。

输出格式说明

  • 单关键字(chi):生成一个局部向量 vector_local,长度为该处理器上的 improper 条数(全局合计为系统 improper 总数,受 group 过滤影响)。
  • 多关键字:生成局部数组 array_local,行数同上、列数等于关键字个数。当前仅 chi 一个关键字,但接口已按多列数组设计(size_local_cols = nvalues),未来新增关键字时无需改动输出框架。
  • 任何使用局部值作为输入的命令(dump local、compute reduce、fix ave/histo 等)均可直接访问。

前置条件与限制

源码(compute_improper_local.cpp)在构造时即做两类检查:

  1. atom->avec->impropers_allow == 0 时报错 Compute improper/local used when impropers are not allowed——即原子风格必须支持 improper 拓扑(如 atom_style full、molecular),纯原子风格(atomic)下不可用;
  2. init() 中若 force->improper == nullptr 报错 No improper style is defined for compute improper/local——即必须先通过 improper_style 定义 improper 势(哪怕是 improper_style zero),才能调用本 compute。

另外,大多数 improper 风格属于 MOLECULE 包,需要 LAMMPS 以该包构建,详见 improper_style 命令。improper_style 默认值为 none,也就是说不显式设置 improper 风格时,本 compute 无法使用。

单元测试 compute-improper_local.yaml 提供了可复现的验证环境:其前提是 atom full + compute improper/local,后置命令为 compute test all improper/local chi,输入文件为 in.fourmol(29 个原子、24 条键、30 个键角、31 个二面角、2 条 improper),并断言了 1.7634279879702712e+00、5.6733407421975537e+00 两个角度参考值。这意味着:

  • 该 compute 的正确性由 LAMMPS 官方测试框架持续回归验证;
  • 用户可以用相同的输入文件(data.fourmol,含 2 个 improper 拓扑)在自己的构建上快速自查 chi 输出是否与参考值一致。

总结

compute improper/local 是 LAMMPS 局部数据输出体系中面向 improper 拓扑的专用 compute:

  • 语法极简:compute ID group-ID improper/local chi,仅一个关键字;
  • 语义清晰:χ 为 4 原子 improper 的平面外角(度),与 improper_style harmonic 等势函数的定义一致,且只统计 4 原子全在 group 内的 improper;
  • 实现完整:源码独立完成最小镜像、向量几何、球面三角合成与角度换算,并行安全(按存储原子去重计数);
  • 搭配使用:与 compute property/local(iatom1..iatom4、itype)和 dump local 联用,可导出"哪条拓扑、多大角度"的完整逐条记录,是构型检查、力场标定与数据后处理的常用工具链。
登录后查看全文
lammps