LAMMPS `compute improper` 命令详解:拆分混合 improper 势能中各子样式的能量贡献
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 的构造函数做了三件关键的事:
- 参数个数检查:
narg != 3(compute + ID + group + improper 共 4 个 token,narg为 3)时报 "Illegal compute improper command"; - 设置输出标志:
vector_flag = 1(存在全局向量)、extvector = 1(向量为 extensive)、peflag = 1(属于势能类 compute)、timeflag = 1(记录调用时间步); - 通过
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() 是核心实现,逻辑分三步:
- 记录
invoked_vector = update->ntimestep,并校验update->eflag_global是否等于当前时间步——即确认该时间步确实统计了全局能量标志,否则报错(见上文 4.3); - 从
improper->styles<a href="https://link.gitcode.com/i/1cd8f8572e9d7ba90bb526f4eacca007" target="_blank">i]->energy读取每个子样式累积的能量到emine[i]。这里的energy是 [improper.h 中Improper基类声明的成员变量,由每个子样式在自身compute()中被填充; - 用
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 生成一个角度值,而不是为每个子样式生成一个能量值。
八、使用注意事项
- 必须配合 hybrid 使用:当前 improper 样式必须为
improper_style hybrid,否则命令在初始化时报错; - group 参数被忽略:写
all或其他 group 名对结果无影响; - 值域语义:输出为 extensive 能量值,单位跟随当前 units 设置;
- 重启限制:与 improper_style.rst 中说明的一致,hybrid 样式在二进制重启文件(restart)中只保存子样式列表,不保存各子样式的系数,因此从 restart 继续计算时必须重新执行
improper_coeff命令,否则系数丢失; - 时间步有效性:向量只在能量被统计的时间步可访问,否则报 "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"的三条语义,即可在力场参数调试、能量分解分析等场景中直接运用。