LAMMPS compute inertia/chunk 命令完全指南:逐块惯量张量计算与输出
LAMMPS compute inertia/chunk 命令完全指南:逐块惯量张量计算与输出
本指南以 doc/src/compute_inertia_chunk.rst 为骨架,结合 src/compute_inertia_chunk.cpp 源码与 unittest/commands/test_compute_chunk.cpp 单元测试,系统讲解 LAMMPS 中按"块(chunk)"计算惯量张量的方法,涵盖语法、物理原理、周期边界处理、有限尺寸粒子自转惯量的平行轴定理、输出格式与实战配置,帮助读者掌握对分子、空间 bin 等任意分块系统逐块量化旋转惯性的能力。
一、命令概述与语法
compute inertia/chunk 是 LAMMPS 提供的块级惯量张量计算命令,用于对由 compute chunk/atom 定义的多个原子块,分别计算各自的对称惯量张量。其核心语法为:
compute ID group-ID inertia/chunk chunkID
三个参数的语义如下:
| 参数 | 说明 |
|---|---|
ID |
该 compute 的标识符,命名规则与 compute 命令 中说明一致 |
group-ID |
参与计算的原子组 ID,只统计组内原子 |
chunkID |
由 compute chunk/atom 命令定义的块计算 ID |
典型用法示例:
compute 1 fluid inertia/chunk molchunk
这里 molchunk 是一个先前定义好的 compute chunk/atom 的 ID。命令行强制要求恰好 4 个参数,否则会报错——源码中通过 if (narg != 4) error->all(FLERR, "Illegal compute inertia/chunk command"); 显式校验(见 src/compute_inertia_chunk.cpp)。
二、分块机制:chunk 是什么
在 LAMMPS 中,chunk 由 compute chunk/atom 命令定义,它负责把每个原子分配到唯一一个块(或不分配任何块),并为每个原子打上 chunk ID。常见的分块方式包括:
- 按分子(
style molecule):每个分子一个块,用于分析分子级转动惯量; - 按空间网格(
style bin/1d、bin/2d、bin/3d、bin/sphere、bin/cylinder):把模拟盒切成空间 bin,用于分析空间分布的惯性属性; - 按原子类型(
style type); - 按自定义量(
c_ID、f_ID、v_name):基于任意 per-atom 计算、fix 或变量动态分块。
关于如何定义分块并利用它度量系统属性,可参考 Howto chunk 页面中的详细介绍和示例。
分块与分组的作用域
需要特别注意的是,compute chunk/atom 自身定义了一个 group:不属于该组的原子 chunk ID 为 0,表示"未分配块",它们不会参与本 compute 的计算。而 compute inertia/chunk 命令本身又指定了自己的 group-ID,只有同时满足"在本组内"且"chunk ID 非 0"的原子才会被计入。
如果你只想把"拥有非零 chunk ID 的原子"全部纳入计算,可以直接对 inertia/chunk 指定 all 组,这是文档推荐的简便做法。
三、物理原理:惯量张量的逐块计算
3.1 计算的内容
对于每个块,本命令计算对称惯量张量的 6 个独立分量,顺序固定为:
Ixx, Iyy, Izz, Ixy, Iyz, Ixz
数学上,惯量张量定义为对块内每个原子求和:
I = Σ m_i [ (r_i - r_cm)² · 1 − (r_i − r_cm) ⊗ (r_i − r_cm) ] + Σ I_i
其中 r_cm 是该块质心位置,I_i 是第 i 个粒子绕自身中心的转动惯量——对点粒子此项为零,对有限尺寸粒子为粒子形状本身的惯量(详见下文)。这也是 compute inertia(全局版本,作用于整个 group)中给出的同一定义,inertia/chunk 只是把同一物理量按块分解。
3.2 源码实现的两步流程
从 src/compute_inertia_chunk.cpp 的 compute_array() 可以看出实现分两个阶段:
第一步:逐块质心计算。 遍历局部原子,累加每块质量与 unwrap 坐标加权和,再通过两次 MPI_Allreduce 汇总得到全系统质量 masstotal 与质心 comall,最后除以质量归一化:
for (i = 0; i < nchunk; i++) {
if (masstotal[i] > 0.0) {
comall[i][0] /= masstotal[i];
...
}
}
第二步:惯量张量累加。 再次遍历原子,用相对质心的位移 dx, dy, dz 累加张量分量:
inertia[index][0] += massone * (dy*dy + dz*dz); // Ixx
inertia[index][1] += massone * (dx*dx + dz*dz); // Iyy
inertia[index][2] += massone * (dx*dx + dy*dy); // Izz
inertia[index][3] -= massone * dx * dy; // Ixy
inertia[index][4] -= massone * dy * dz; // Iyz
inertia[index][5] -= massone * dx * dz; // Ixz
最后同样通过 MPI_Allreduce 对 6×Nchunk 个值做跨进程归约,得到每块的全局张量。
3.3 周期边界:使用 unwrapped 坐标
文档明确指出:原子的坐标以 "unwrapped"(解包裹)形式参与惯量张量计算,即通过每个原子的 image flag 还原其真实轨迹坐标,从而正确计入原子跨越周期边界导致的位移。
这在源码中体现为 domain->unmap(x[i], image[i], unwrap) 调用——它根据 image flag 把包裹坐标映射回真实坐标。相关背景可参阅:
- dump 命令 中对 "unwrapped" 坐标的讨论;
- read_data 命令 的 Atoms 部分对 image flag 如何设置和使用的说明。
如果希望重置 image flag(例如清零),可以在调用本 compute 之前使用 set image 命令(见 set 命令):
set group all image 0 0 0
四、2Sep2026 新增:有限尺寸粒子的自转惯量
这是本命令最重要的近期行为变更(.. versionchanged:: 2Sep2026):此前所有原子一律按点质量处理;新版本开始,对于有限尺寸粒子(finite-size particles),粒子自身形状的转动惯量通过平行轴定理叠加到对应块上。
适用粒子类型与处理方式:
| 粒子类型 | 自转惯量来源 |
|---|---|
| 有限尺寸球体(sphere) | 按 0.4 · m · r² 计算(源码常量 SINERTIA = 0.4) |
| 椭球(ellipsoid) | 由形状半轴与取向四元数计算,与 fix rigid 一致 |
| 线段(line) | 由长度与取向角计算,与 fix rigid 一致 |
| 三角形(tri) | 由存储的惯量与取向计算,与 fix rigid 一致 |
| 超椭球(superellipsoid) | 使用粒子自身存储的每粒子惯量 |
| body 粒子 | 使用粒子自身存储的每粒子惯量 |
从源码看,该逻辑在 src/compute_inertia_chunk.cpp 中按类型分支实现:依次检查椭球/超椭球、线、三角、body 的 bonus 数据,最后才判断纯球(radius[i] > 0.0)分支。注释特别强调:椭球/超椭球/三角形/body 粒子同样携带包围球半径,因此纯球分支必须放在最后,只捕获真正的球体,避免误判。
一个实现细节值得留意:MathExtra::inertia_* 系列工具函数返回的是 Voigt 排序的 6 向量 (Ixx,Iyy,Izz,Iyz,Ixz,Ixy)(见 src/math_extra.cpp),与 compute inertia/chunk 输出的列序 (Ixx,Iyy,Izz,Ixy,Iyz,Ixz) 不同,因此源码在累加时做了显式重映射:
inertia[index][3] += ivec[5]; // Ixy
inertia[index][4] += ivec[3]; // Iyz
inertia[index][5] += ivec[4]; // Ixz
单元测试的验证
unittest/commands/test_compute_chunk.cpp 中的 ComputeInertiaChunkTest 针对该特性提供了 4 组解析可验证的测试(对应 issue #3710):
- Ellipsoid 测试:两个轴对齐椭球(半轴 a=1,b=2,c=3,m1=1 在原点,m2=3 在 (5,0,0)),期望张量
(10.4, 26.75, 22.75, 0, 0, 0); - Sphere 测试:两个半径 1、质量 1 的球位于 (0,0,0) 与 (4,0,0),期望张量
(0.8, 8.8, 8.8, 0, 0, 0)——其中Ixx = 0.8正是球的纯自转惯量0.4·m·r²; - Superellipsoid 测试:
atom_style ellipsoid superellipsoid下走bonus_super分支,默认 blockiness (2,2) 下结果与椭球一致(测试注释提示质量必须先于形状设置,因为存储惯量在 set-shape 时计算); - Body 测试:单个 body/nparticle 粒子,存储的对角惯量
(2,3,4)应被单块原样返回。
此外,unittest/force-styles/tests/compute-inertia_chunk.yaml 提供了基于 in.fourmol(29 个原子、4 个分子)的参考输出,可用作回归验证基准。
五、输出格式:全局数组及其引用方式
compute inertia/chunk 输出一个全局数组(global array):
- 行数 = 块数
Nchunk(由指定的compute chunk/atom计算得到,行数可变,源码中size_array_rows_variable = 1); - 列数 = 6,对应每块惯量张量的 6 个分量,顺序
Ixx, Iyy, Izz, Ixy, Iyz, Ixz。
数组中的值为 intensive(强度量,不随原子数缩放),单位是质量 × 距离²,具体单位制由 units 命令 决定。
该数组可以被任何接受全局数组输入的命令使用,例如 fix ave/time、compute reduce 等。LAMMPS 输出选项的完整概览见 Howto output。
最简输出方案:fix ave/time
文档推荐用 fix ave/time 将结果写入文件,最小可用示例:
compute cc1 all chunk/atom molecule
compute myChunk all inertia/chunk cc1
fix 1 all ave/time 100 1 100 c_myChunk[*] file tmp.out mode vector
要点解析:
c_myChunk[*]引用全局数组的全部 6 列;mode vector表明按向量/数组方式输出(每块一行、6 列);mode关键字在 fix ave/time 中取值scalar或vector,用于数组输入时必须为vector;100 1 100表示每 100 步采样 1 次、共平均 100 个样本,即每 10000 步输出一次。
六、注意事项与使用建议
- 分组双重过滤:只有同时满足
inertia/chunk的 group 与chunk/atom自身 group 的原子才贡献计算;chunk ID = 0 的原子永远不参与。需要"全量非零 chunk"时对inertia/chunk指定all。 - unwrapped 坐标:结果受 image flag 影响,若在特定场景下希望按包裹坐标计算,需先用
set image重置(例如置 0)。 - 质心零质量块:源码中
masstotal[i] > 0.0才做归一化,空块或零质量块的质心/惯量保持零值;配合compress yes可压缩掉无原子块,减少输出行数。 - 与全局版本的区别:compute inertia 只对整个 group 输出长度 6 的全局向量,而
inertia/chunk输出 Nchunk×6 的全局数组,适合逐分子、逐 bin 的细粒度分析。两者共享相同的物理定义与有限尺寸粒子处理。 - 与 fix rigid 的一致性:对球、椭球、线、三角粒子,本命令的自转惯量处理与 fix rigid 完全一致,因此可直接用本命令输出的张量校验刚性体定义的一致性;超椭球与 body 粒子则使用各自存储的惯量。
- 配套命令:
compute gyration(回转半径)、variable inertia()函数(见 variable 命令)也是与转动特性相关的分析手段,可结合使用。
七、快速上手指南:从零配置一个按分子惯量分析
综合以上内容,一个完整的按分子惯量分析工作流如下:
units lj # 设定单位制(决定输出量纲)
atom_style full # 支持分子信息的原子风格
read_data data.fourmol
# 1) 定义分块:按分子
compute molchunk all chunk/atom molecule
# 2) 定义惯量张量计算(对全部原子、按上面分块)
compute iner all inertia/chunk molchunk
# 3) 周期性输出到文件:每 10000 步输出一次每块的 6 分量
fix out all ave/time 100 1 100 c_iner[*] file inertia_per_mol.out mode vector
# 4) 运行 0 步即可先验证一次输出
run 0 post no
输出文件 inertia_per_mol.out 中每一行对应一个分子块,6 列依次为该分子惯量张量的 Ixx, Iyy, Izz, Ixy, Iyz, Ixz(单位为 mass×distance²)。若模拟中涉及球、椭球等有限尺寸粒子,则张量已自动包含粒子自转惯量贡献,无需额外处理。
八、实现架构速览
- 入口与注册:src/compute_inertia_chunk.h 中通过
ComputeStyle(inertia/chunk, ComputeInertiaChunk)注册命令;类继承自 src/compute_chunk.h 的ComputeChunk基类,复用nchunk、maxchunk、cchunk等块级基础设施。 - 核心计算:src/compute_inertia_chunk.cpp 的
compute_array(),两遍原子遍历 + 跨进程归约。 - 内存管理:
allocate()(src/compute_inertia_chunk.cpp)按maxchunk分配massproc/masstotal、com/comall、inertia/inertiaall六组数组;memory_usage()报告总开销约2·(1 + 3 + 6)·maxchunk个 double。 - 数学工具:src/math_extra.cpp 中的
MathExtra::inertia_ellipsoid / inertia_line / inertia_triangle等函数,均以 Voigt 6 向量形式返回空间系惯量。 - 验证体系:unittest/commands/test_compute_chunk.cpp(解析基准)与 unittest/force-styles/tests/compute-inertia_chunk.yaml(回归基准)。
九、限制与总结
- Restrictions:官方文档声明本命令无使用限制。
- Related:相关命令为 compute inertia 与 variable inertia() 函数。
- Default:无默认参数。
compute inertia/chunk 是 LAMMPS 中面向"多体块"场景的标准惯量分析工具:它把惯量张量计算从单一 group 扩展到任意数量的分子块、空间 bin 或自定义分块,并通过 unwrapped 坐标与平行轴定理正确计入周期边界效应和有限尺寸粒子的形状惯量。配合 fix ave/time 输出,可在分子动力学模拟中稳定追踪每个分子的转动惯性演化,为旋转动力学、刚性体建模和空间各向异性分析提供直接的数值依据。