LAMMPS compute omega/chunk 详解:按分子或空间分块计算角速度

原创2026-10-14 18:55:061,948 阅读
文章标签:科学计算高性能计算科研

LAMMPS compute omega/chunk 详解:按分子或空间分块计算角速度

导读

compute omega/chunk 是 LAMMPS 中一个面向"分块(chunk)"分析的全局数组型 compute 命令,它把体系中的原子按 compute chunk/atom 预先定义的分子、空间 bin 或聚类等分组方式划分成多个 chunk,并逐 chunk 计算角速度矢量(ω 的三个分量)。本文以 compute_omega_chunk.rst 官方文档为主体,结合 src/compute_omega_chunk.cpp 源码与 unittest/force-styles/tests/compute-omega_chunk.yaml 测试用例,讲解其语法、物理原理、周期边界处理、输出格式以及奇异惯量张量的底层求解策略。读完本文,你将能够独立用它计算任意分子或空间区域集合的瞬时角速度,并通过 fix ave/time 输出为时间平均轨迹文件。

命令语法

compute ID group-ID omega/chunk chunkID
参数 含义
ID compute 命令自定义的标识符,规则见 compute 命令文档
group-ID 参与计算的原子组,只有该组内的原子才计入统计
omega/chunk 本 compute 的样式名(style)
chunkID 由 compute chunk/atom 命令 定义的 chunk 计算的 ID

一个典型用法示例:

compute 1 fluid omega/chunk molchunk

这里 fluid 是参与计算的组,molchunk 是先前定义好的 compute chunk/atom 的 ID。

chunk 是什么

在 LAMMPS 中,chunk 是原子的一类集合,由 compute chunk/atom 命令负责划分。每个原子被分配到一个 chunk(对应一个正整数 chunk ID),或不被任何 chunk 包含(chunk ID = 0)。一个 chunk 可以是:

  • 一个分子中的所有原子(style molecule);
  • 一个空间 bin 中的原子(style bin/1d、bin/2d、bin/3d、bin/sphere、bin/cylinder);
  • 同一类型的原子(style type);
  • 由其他 compute、fix 或变量输出值划分的集合(style c_ID、f_ID、v_name 等)。

chunk 的划分方式、region/nchunk/compress/bound/pbc 等关键字以及动态 chunk 的细节,请参考 compute chunk/atom 文档 和 Howto chunk 使用指南。后者同时列出了与 omega/chunk 同族的 angmom/chunk、com/chunk、gyration/chunk、inertia/chunk、temp/chunk、vcm/chunk 等十余个 per-chunk 分析 compute,它们在数据处理框架上共享同一套 chunk 基础设施。

计算原理:L = I·ω

该 compute 对每个 chunk 计算角速度矢量的三个分量,依据刚体动力学基本关系:

L = I · ω

其中 L 是 chunk 的角动量矢量,I 是其惯量张量(转动惯量张量),ω 即为所求角速度。计算分四步进行:

  1. 统计每个 chunk 内原子质量,得到总质量,并求出质心(COM);
  2. 以质心为参考点累加每个原子对惯量张量的贡献;
  3. 累加每个原子相对质心的角动量贡献;
  4. 求解 L = I·ω 得到 ω。

在 src/compute_omega_chunk.cpp 的 compute_array() 中,这四个阶段体现为对局部数据的两次遍历 + 三次 MPI_Allreduce 全局归约,所有阶段都严格限制在 mask[i] & groupbit 的原子以及 ichunk[i] > 0(确实被划分到某个 chunk)的原子上:

  • 质心阶段:先累加 massproc(分块质量)与加权坐标 com,MPI_Allreduce 后用 comall[i] /= masstotal[i] 归一化得到每 chunk 质心;
  • 惯量张量阶段:以质心为原点计算位移 dx/dy/dz,按 I_xx = Σ m(dy²+dz²) 等经典公式累加 6 个独立分量(Voigt 序:xx、yy、zz、xy、yz、xz,其中交叉项带负号);
  • 角动量阶段:用 L = Σ m(r × v) 累加角动量三个分量;
  • 求解阶段:见下文"奇异惯量张量的处理"。

组(group)语义与原子选取

需要注意双层过滤语义:

  • 本命令的 group-ID 决定哪些原子参与统计;
  • 而 compute chunk/atom 自身也有一个组。不在该组内的原子其 chunk ID 被置为 0,表示"不属于任何 chunk",自然也不会被本 compute 计入。

因此,若只是想统计所有"被分配了非零 chunk ID"的原子,可以直接把本命令的组指定为 all:

compute cc1 all chunk/atom molecule
compute myChunk all omega/chunk cc1

此时"分子 ID = 0"的自由原子因 chunk ID = 0 而被自动排除。从源码看,过滤逻辑为 if (mask[i] & groupbit) { index = ichunk[i] - 1; if (index < 0) continue; },即 chunk ID 减 1 后为负(chunk ID = 0)的原子直接跳过,这正是两层过滤的具体实现。

周期边界与 unwrapped 坐标

文档强调:原子坐标对 chunk 角速度的贡献采用"unwrapped(解卷绕)"形式,即利用每个原子的 image flag 还原其在真实空间中的坐标,从而把原子穿出周期边界后产生的"映像跳跃"完全计入:

  • dump custom 命令中关于 unwrapped 坐标的说明见 dump 文档;
  • image flag 的含义与设置方式见 read_data 命令文档 的 Atoms 部分;
  • 若需要,可在调用本 compute 之前用 set image 命令 把 image flag 复位(例如清零)。

源码中的具体实现是 domain->unmap(x[i], image[i], unwrap):先还原位置,再以质心为原点计算相对位移;角动量阶段则使用 domain->unmap(...) 同时还原位置与速度(vunwrap),L = Σ m(r × v) 中的 r 与 v 均以 unwrapped 形式参与。这正是本命令能正确处理"分子跨边界旋转"场景的关键——否则分子跨越 box 边界时角速度会被严重算错。

输出信息:全局数组

本 compute 输出一个全局数组(global array):

  • 行数 = Nchunk(由 compute chunk/atom 计算出的 chunk 总数,行数随 chunk 数动态变化);
  • 列数 = 3,依次为每个 chunk 角速度的 x、y、z 分量;
  • 数值为"强度量(intensive)",单位是 velocity/distance(速度/距离,即 1/时间量纲),具体单位制见 units 文档。例如在 real 单位制下为 1/皮秒量级。

凡是接受 compute 全局数组作为输入的命令(fix ave/time、variable、thermo_style 等)都可以引用它。全局数组输出机制总览见 Howto output 使用指南。

从源码看,数组行数通过 size_array_rows_variable = 1 标记为动态变化,compute_array() 每次被调用都会把 size_array_rows 刷新为当前 nchunk;内存随 chunk 数增长按需重分配(if (nchunk > maxchunk) allocate()),并在 compute_omega_chunk.cpp 的 memory_usage() 中给出开销公式。

完整示例:按分子统计并输出时间平均角速度

文档给出了输出结果最简洁的方式——用 fix ave/time 将每 chunk 的角速度写入文件:

compute cc1 all chunk/atom molecule
compute myChunk all omega/chunk cc1
fix 1 all ave/time 100 1 100 c_myChunk[*] file tmp.out mode vector

各命令说明:

  • 第 1 行:把体系按分子 ID 划分 chunk(molecule 样式,无需参数);
  • 第 2 行:对每个分子 chunk 计算角速度;
  • 第 3 行:每 100 步对 c_myChunk<a href="https://link.gitcode.com/i/bc09fd213b63754edd82024e6777feb3" target="_blank">*](所有列的全局数组)做一次平均,共平均 1 次,每 100 步输出一行到 tmp.out,mode vector 表示按向量/数组逐列展开输出。关于 fix ave/time 的 Nfreq/Nrepeat/Nevery 参数语义见 [fix ave/time 文档。

fix ave/time 会通过 src/compute_chunk.cpp 中的 lock_enable()/lock() 系列方法对 compute chunk/atom 加锁,确保在平均周期内 chunk 划分与数组规模保持稳定,这也是文档示例能够稳定工作的底层保障。

源码级原理:奇异惯量张量的处理

惯量张量求逆在数学上并非总能直接进行。源码用一个阈值 EPSILON = 1.0e-6 区分两种情况(src/compute_omega_chunk.cpp):

1. 非奇异情形(determinant > EPSILON):直接对 3×3 惯量张量求逆,再由 ω = I⁻¹ · L 解出三个分量。

2. 近奇异/奇异情形:典型如双原子分子或线性分子——绕分子轴的转动惯量为零,惯量张量行列式为零,直接求逆会发散。此时改用特征分解:

  • 用 MathEigen::jacobi3()(声明见 src/math_eigen.h)对惯量张量做 Jacobi 特征分解,得到三个主轴方向 ex/ey/ez 与主惯量 idiag;
  • 用 cross3(ex, ey) 与 ez 做点积校验,必要时翻转第三个主轴,保证主轴构成右手系;
  • 将小于 EPSILON * max(idiag) 的主惯量直接置零(对应"绕该轴可无阻力自由旋转"的物理退化方向);
  • 调用 MathExtra::angmom_to_omega()(实现见 src/math_extra.cpp)完成求解:先把角动量投影到体坐标系,除以主惯量得到体坐标系角速度,再投影回空间坐标系;对主惯量为零的轴,其体坐标系角速度分量直接置 0。

这段逻辑确保了即使 chunk 是"单根棒状分子"甚至"两个原子的哑铃",omega/chunk 依然能输出物理上合理、数值上稳定的角速度,而不会产生除零或 NaN。若 Jacobi 迭代未收敛,代码会以 error->all(FLERR, "Insufficient Jacobi rotations for omega/chunk") 报错终止。

与 variable omega() 的关系

文档在 Related commands 中列出了 variable 命令的 omega() 函数。二者的区别在于作用对象:

  • variable omega(group-ID,dim) / omega(group-ID,dim,region-ID) 针对单个组或单个区域计算整体角速度,输出的是标量/向量;
  • compute omega/chunk 针对同一时刻任意多个划分(分子、bin、聚类……)并行计算,输出的是每 chunk 一行的全局数组。

因此当需要"按分子逐个体分析"或"按空间网格逐格分析"时,omega/chunk 是更匹配的工具;而 variable omega() 更适合对单一宏观对象(如整个纳米颗粒)做实时统计。

约束与默认值

  • Restrictions:无(核心功能不需要额外包,属 LAMMPS 内置命令;compute omega/chunk 在 src/compute_omega_chunk.h 中注册为 ComputeStyle(omega/chunk, ComputeOmegaChunk));
  • Default:无(命令不带任何可选关键字)。

回归测试验证

仓库的 force-styles 测试套件为它提供了数值基准:unittest/force-styles/tests/compute-omega_chunk.yaml。该测试要求 atom full 风格与 compute omega/chunk 前提条件,后处理中构造:

compute molchunk all chunk/atom molecule
compute test all omega/chunk molchunk

输入为 in.fourmol(29 个原子、4 分子体系,units real、atom_style full),并在 global_array 字段给出参考输出(epsilon: 1e-08 容差)。这意味着任何对 omega/chunk 数值实现的修改都必须保证与这份高精度参考值一致,读者也可以把这份 yaml 作为验证自己输入脚本正确性的基准样例。

小结

compute omega/chunk 把"刚体角速度"这一经典力学量推广到任意多组原子划分上:先由 compute chunk/atom 建立分组,再以质心为原点、以 unwrapped 坐标累加惯量张量与角动量,最后通过惯量张量求逆或特征分解求解 L = I·ω。它特别适合分子动力学中追踪每个分子/团簇/空间 bin 的旋转行为,配合 fix ave/time 即可得到任意时段的时间平均角速度,是 Howto chunk 体系下与 angmom/chunk、inertia/chunk、gyration/chunk 等配套使用的高频分析工具。

登录后查看全文
lammps