LAMMPS `compute improper` 命令详解:拆分混合 improper 势能中各子样式的能量贡献

原创2026-10-14 18:20:431,749 阅读
文章标签:科学计算高性能计算科研

LAMMPS compute improper 命令详解:拆分混合 improper 势能中各子样式的能量贡献

compute improper 是 LAMMPS 中专门用于量化分析的 compute 命令,它的唯一用途是提取由 improper_style hybrid 定义的多个 improper 子样式各自贡献的能量,从而回答"当前构型下 harmonic 子样式贡献了多少能量、cvff 子样式又贡献了多少"这类问题。本文以 compute_improper.rst 文档为核心骨架,结合 compute_improper.cpp 源码与 compute-improper.yaml 测试用例,完整讲解其语法、输出语义、源码实现原理与典型使用场景。

一、为什么需要 compute improper:混合 improper 势能的可观测性问题

LAMMPS 通过 improper_style 命令设定 improper 相互作用的势函数公式,作用于四原子(quadruplet)体系,用于描述偏离平面构型(out-of-plane)的形变能。一个复杂体系往往同时存在多种不同类型的 improper 相互作用——例如聚合物流动区域(improper 类型 1)适合用 harmonic 势,而壁面边界区域(improper 类型 2)适合用 cvff 势(见 improper_hybrid.rst)。

此时必须使用 hybrid 样式:

improper_style hybrid harmonic cvff
improper_coeff 1 harmonic 120.0 30
improper_coeff 2 cvff 20.0 -1 2

上述 improper_coeff 将 improper 类型 1 交给 harmonic 子样式(系数 K=120.0、χ₀=30),类型 2 交给 cvff 子样式(系数 K=20.0、d=-1、n=2)。

hybrid 子样式会把所有子样式的能量合并成单一的总能量。系统总势能固然可以用 compute pe 得到,但总能量无法回答"哪个子样式贡献了多少"。这正是 compute improper 存在的意义:它生成一个全局向量,逐一给出每个 hybrid 子样式单独计算的 improper 能量,供输出或进一步处理使用。

二、语法与示例

compute improper 的语法极为简洁,只有 ID、group-ID 和样式名三个参数:

compute ID group-ID improper
  • ID、group-ID 的通用规则见 compute 命令文档;
  • improper 为本 compute 的样式名,不可省略或替换。

官方文档给出的示例:

compute 1 all improper

一个需要特别强调的行为是:compute improper 中指定的 group 会被忽略("The group specified for this command is ignored")。原因是该 compute 的输出对象是每个 hybrid 子样式在全局范围内累计的能量,而不是按 group 筛选的原子集合,因此 group 参数对结果没有任何影响。

三、功能语义:从 hybrid 子样式中提取能量

该 compute 定义的计算任务为:提取 improper_style hybrid 中每个 improper 子样式分别计算得到的 improper 能量。这些值被暴露出来,可被其他命令作为输出或进一步处理的输入。

其典型应用场景是:当你使用 hybrid 样式时,希望知道总能量中某一个或几个子样式的贡献占比,例如验证某个新的势函数参数调整后对整体能量的影响幅度。

要使其正常工作,系统当前必须确实使用了 hybrid improper 样式;如果当前 improper 样式不是 hybrid,命令会在初始化阶段直接报错终止(见下文源码分析)。

四、输出信息:一个长度等于子样式数的全局向量

compute improper 计算得到一个全局向量(global vector),其长度 N 等于 improper_style hybrid 命令中定义的子样式(sub-style)个数。向量元素通过索引 1 到 N 访问:第 i 个元素就是第 i 个子样式贡献的 improper 能量。

这些值可以被任何以 compute 的全局标量或向量作为输入的命令使用。LAMMPS 输出体系的整体概览参见 Howto output 页面。向量中的每个值是 extensive(广延量),单位与当前 units 设置下的能量单位一致(例如 real 单位的 kcal/mol、metal 单位的 eV、lj 单位的约化能量)。

4.1 通过 thermo_style custom 输出

将向量元素接入热力学输出是最直接的用法。在 thermo_style custom 中,c_ID[I] 表示读取 compute ID 的全局向量第 I 个分量:

compute eimp all improper
thermo_style custom step temp pe c_eimp[1] c_eimp[2]

配合 units 页面关于广延量的说明可知:由于这些分量是 extensive 值,直接用于 thermo 输出时不会被按原子数归一化。

4.2 通过 compute reduce 聚合

如果你关心"所有 improper 子样式的能量总和",可以用 compute reduce 对全局向量做归约。reduce 的 sum 模式把向量各分量相加为全局总和,ave 模式则先求和再除以分量个数,min/max/sumsq 等模式还可用于进一步分析能量分布:

compute 1 all improper
compute 2 all reduce sum c_1[*]

注意 compute improper 的输出本身就是全局向量,而 compute_reduce.rst 文档明确说明它同时支持对全局向量做归约,这正是上述用法的依据。

4.3 输出限制与报错

由于该向量属于"计算势能"类输出,它只在能量确实被统计(tallied)的时间步上有效。若在能量未统计的时间步访问该向量,LAMMPS 会报错 "Energy was not tallied on needed timestep"(对应 utils::errorurl(22)),提示用户需要在该时间步触发能量统计(例如通过 thermo 或 compute pe 等)。

五、源码级实现剖析

5.1 样式注册

compute improper 在 compute_improper.h 中通过宏注册:

ComputeStyle(improper,ComputeImproper);

类 ComputeImproper 继承自 Compute,仅实现 init() 与 compute_vector() 两个虚函数,成员只有 nsub(子样式数)、指向 ImproperHybrid 的指针以及两个 double 数组 emine、vector。

5.2 构造函数:强制绑定 hybrid 样式

compute_improper.cpp 的构造函数做了三件关键的事:

  1. 参数个数检查:narg != 3(compute + ID + group + improper 共 4 个 token,narg 为 3)时报 "Illegal compute improper command";
  2. 设置输出标志:vector_flag = 1(存在全局向量)、extvector = 1(向量为 extensive)、peflag = 1(属于势能类 compute)、timeflag = 1(记录调用时间步);
  3. 通过 dynamic_cast<ImproperHybrid *>(force->improper_match("hybrid")) 查找当前 improper 样式,若不是 hybrid 则报错 "Improper style for compute improper command is not hybrid";并令 size_vector = nsub = improper->nstyles,即向量长度直接取自 ImproperHybrid::nstyles。

5.3 init():运行时再次校验

init() 在每次运行初始化阶段重新检查 improper 样式是否仍为 hybrid,并校验 improper->nstyles 与构造时的 nsub 一致(即 hybrid 子样式列表是否在运行过程中被更改),不一致则报错 "Improper style for compute improper command has changed"。

5.4 compute_vector():能量收集与跨进程归约

compute_vector() 是核心实现,逻辑分三步:

  1. 记录 invoked_vector = update->ntimestep,并校验 update->eflag_global 是否等于当前时间步——即确认该时间步确实统计了全局能量标志,否则报错(见上文 4.3);
  2. 从 improper->styles<a href="https://link.gitcode.com/i/1cd8f8572e9d7ba90bb526f4eacca007" target="_blank">i]->energy 读取每个子样式累积的能量到 emine[i]。这里的 energy 是 [improper.h 中 Improper 基类声明的成员变量,由每个子样式在自身 compute() 中被填充;
  3. 用 MPI_Allreduce(emine, vector, nsub, MPI_DOUBLE, MPI_SUM, world) 对所有 MPI 进程做全局求和,得到跨进程一致的最终向量。

5.5 与 ImproperHybrid 的协作机制

能量之所以能按子样式分开,根本原因在 improper_hybrid.cpp 的 ImproperHybrid::compute():

  • 在重建邻居列表的时间步(neighbor->ago == 0),它依据 map[improperlist_orig[i][4]] 把总 improper 列表按 improper 类型拆分到各子样式的独立 improperlist[m] 中(nimproperlist[m] 记录各子样式条数);
  • 随后对每个子样式 m,临时把 neighbor->improperlist 指向该子样式的列表,调用 styles[m]->compute(eflag, vflag),并把各子样式的 energy、virial[6]、eatom、vatom 累加进 hybrid 自身;
  • 因此每个子样式对象内部的 energy 成员始终只包含该子样式自身的能量,ComputeImproper::compute_vector() 直接读取即可。

关于 hybrid 子样式的定义与系数分配细节,可进一步参考 improper_hybrid.cpp 的 settings()(逐个实例化子样式并切分参数)和 improper_hybrid.cpp 的 coeff()(支持以 none 关闭某些 improper 类型、以 skip 作为 class2 AngleAngle 系数的占位符)。

六、测试用例验证

仓库自带的 force-styles 单元测试 compute-improper.yaml 直接验证了该 compute 的行为:

post_commands: |
  improper_style hybrid harmonic cvff
  improper_coeff 1 harmonic 10.0 180.0
  improper_coeff 2 cvff      8.0 -1 2
  compute test all improper
input_file: in.fourmol
natoms: 29
global_vector: |-
  2  9.5317814751624169e+01  1.9752641665565562e-01

测试使用 in.fourmol 作为输入体系(29 个原子),前置条件(prerequisites)声明需要 atom full、compute improper、improper hybrid、improper harmonic、improper cvff。其预期输出 global_vector 的长度为 2(即两个子样式),元素值分别约等于 95.3178(harmonic 子样式)与 0.1975(cvff 子样式)——这与"向量长度等于 hybrid 子样式数、每个分量对应该子样式能量"的语义完全一致,可作为理解输出语义的量化参照。

七、与 compute improper/local 的区分

compute improper 常被初学者与 compute improper/local 混淆,二者有本质区别:

对比维度 compute improper compute improper/local
输出类型 全局向量(长度 = hybrid 子样式数) 局部向量/局部数组(行数 = 体系内 improper 数量)
输出内容 每个子样式的能量总和 每条 improper 相互作用的属性(如 improper 角 chi,单位度)
典型用途 拆分 hybrid 各子样式能量贡献 按条分析每个 improper 角(如配合 compute property/local 与 dump local 输出)

例如 compute_improper_local.rst 中给出的 compute 2 all improper/local chi 会为体系中的每一条 improper 生成一个角度值,而不是为每个子样式生成一个能量值。

八、使用注意事项

  1. 必须配合 hybrid 使用:当前 improper 样式必须为 improper_style hybrid,否则命令在初始化时报错;
  2. group 参数被忽略:写 all 或其他 group 名对结果无影响;
  3. 值域语义:输出为 extensive 能量值,单位跟随当前 units 设置;
  4. 重启限制:与 improper_style.rst 中说明的一致,hybrid 样式在二进制重启文件(restart)中只保存子样式列表,不保存各子样式的系数,因此从 restart 继续计算时必须重新执行 improper_coeff 命令,否则系数丢失;
  5. 时间步有效性:向量只在能量被统计的时间步可访问,否则报 "Energy was not tallied on needed timestep"。

九、相关命令

  • compute pe:计算系统总势能(包含所有 improper 子样式之和,可用于与 compute improper 各分量交叉核对);
  • compute pair:类似地按 pair 子样式拆分 pair 能量,是理解"按子样式拆分能量"这一设计模式的对偶例子;
  • compute improper/local:逐条输出 improper 角度的 local 版 compute;
  • thermo_style custom 与 Howto output:全局向量的各种输出接入方式。

小结

compute improper 以一行命令解决了混合 improper 势能的可观测性问题:通过读取 ImproperHybrid 内各子样式对象的 energy 成员并经 MPI 归约,将 hybrid 拆分后的能量贡献以全局向量形式暴露给 thermo 输出、compute reduce 等下游消费方。理解其"向量长度 = 子样式数、分量 = 该子样式能量、值为 extensive"的三条语义,即可在力场参数调试、能量分解分析等场景中直接运用。

登录后查看全文
lammps