LAMMPS compute omega/chunk 详解:按分子或空间分块计算角速度
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 是其惯量张量(转动惯量张量),ω 即为所求角速度。计算分四步进行:
- 统计每个 chunk 内原子质量,得到总质量,并求出质心(COM);
- 以质心为参考点累加每个原子对惯量张量的贡献;
- 累加每个原子相对质心的角动量贡献;
- 求解
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 等配套使用的高频分析工具。