LAMMPS compute inertia 命令详解:计算原子组相对质心的惯量张量
LAMMPS compute inertia 命令详解:计算原子组相对质心的惯量张量
compute inertia 是 LAMMPS 中用于计算一个原子组(group)相对其质心的对称惯量张量的全局向量 compute。它在分子刚体动力学分析、转动动能计算、粒子形状对转动惯量贡献的评估等场景中扮演关键角色,并且对跨周期边界的原子采用“unwrapped(去包裹)”坐标处理。读完本文,你将掌握该命令的语法、输出格式、底层实现原理(包括有限尺寸粒子的自旋惯量贡献与平行轴定理),并能通过热力学输出、variable inertia() 函数和单元测试验证结果。
命令语法与基本用法
compute inertia 的语法非常简洁,与 LAMMPS 其他 compute 命令一致:
compute ID group-ID inertia
三个参数的含义:
ID:为这个 compute 指定的唯一标识符;group-ID:要计算惯量张量的原子组,其用法遵循 compute 命令的通用约定;inertia:该 compute 的样式名称(style name)。
一个典型示例:
compute 1 molecule inertia
这条命令定义了标识符为 1 的 compute,计算名为 molecule 的原子组相对其质心的惯量张量。若后续需要读取结果,可通过 c_1[*] 或 c_1[1] 等索引方式引用。
该命令在 LAMMPS 2Sep2026 版本中引入(versionadded:: 2Sep2026),属于较新的全局向量 compute。从源码看,其构造函数强制要求参数个数严格为 3,否则报错 Illegal compute inertia command(参见 compute_inertia.cpp),即不允许携带额外可选参数。
惯量张量的物理定义与数学公式
该 compute 计算的是原子组中所有原子相对组质心 的对称惯量张量:
其中:
- 是原子组的质心位置;
- 求和覆盖组内所有原子 ;
- 是原子 的质量(对每个原子独立质量
rmass与按类型质量mass的原子样式分别取rmass[i]或mass[type[i]]); - 是原子 相对自身中心的惯量。对于点粒子 ;对于有限尺寸粒子(finite-size particles,见 Howto_spherical), 为粒子形状自身的惯量,并通过平行轴定理叠加到轨道项上。
该张量在源代码中通过两项叠加实现(详见下文“源码级实现”一节):轨道项由 Group::inertia() 计算,有限尺寸粒子的自旋项由 Group::inertia_extended() 叠加。
跨周期边界的正确处理:unwrapped 坐标
文档特别强调了一个容易出错的细节:原子的坐标以“unwrapped”形式参与惯量张量计算,即使用每个原子关联的 image flag(镜像标记)。如果不做这种处理,跨过周期边界的原子会被“折叠”回主盒子内部,导致惯量张量出现严重错误。
具体来说:
- 关于 unwrapped 坐标的含义,参见 dump custom 命令的讨论;
- 关于 image flag 及其设置方式,参见 read_data 命令的 Atoms 部分;
- 你可以使用 set image 命令在调用该 compute 之前将 image flag 重置(例如置为 0)。
源码中这一行为体现在 group.cpp:遍历本进程局部原子时,对每个属于目标组的原子先调用 domain->unmap(x[i], image[i], unwrap) 得到去包裹坐标,再以 unwrap[] - cm[] 计算相对质心的位移,从而保证跨周期边界的原子贡献正确。
输出信息与数据格式
compute inertia 输出一个长度为 6 的全局向量(global vector),可通过索引 1–6 访问。六个分量对应对称惯量张量的独立分量,顺序固定为:
| 索引 | 分量 | 含义 |
|---|---|---|
| 1 | 绕 x 轴分量 | |
| 2 | 绕 y 轴分量 | |
| 3 | 绕 z 轴分量 | |
| 4 | x-y 平面交叉项 | |
| 5 | y-z 平面交叉项 | |
| 6 | x-z 平面交叉项 |
该顺序由源码直接确定:compute_inertia.cpp 中将 3×3 对称张量的对应元素依次写入 vector[0..5]。由于张量对称,、、 不会重复输出。
这些值可以被任何接受 compute 全局向量作为输入的命令使用(如 thermo_style custom、variable 等)。关于 LAMMPS 输出选项的综述参见 Howto output。
该向量属于 intensive(强度量) 性质,数值单位是 质量×距离²(mass*distance²),具体取决于当前 units 设置。例如在 metal 单位下单位为 g·Å²,在 real 单位下为 g·Å²,在 lj 单位下为(约化质量×约化长度²)。
源码级实现原理
轨道项:Group::inertia()
compute inertia 的 compute_vector() 调用链如下(compute_inertia.cpp):
- 记录
invoked_vector = update->ntimestep(当前时间步,用于缓存判断); - 若组是动态组(
group->dynamic[igroup]为真),重新计算masstotal; group->xcm(igroup, masstotal, xcm)计算组质心;group->inertia(igroup, xcm, itensor)计算轨道项;group->inertia_extended(igroup, itensor)叠加有限尺寸粒子的自旋项。
Group::inertia()(group.cpp)的核心是逐原子累加:
domain->unmap(x[i], image[i], unwrap);
dx = unwrap[0] - cm[0];
dy = unwrap[1] - cm[1];
dz = unwrap[2] - cm[2];
...
ione[0][0] += massone * (dy*dy + dz*dz);
ione[1][1] += massone * (dx*dx + dz*dz);
ione[2][2] += massone * (dx*dx + dy*dy);
ione[0][1] -= massone * dx*dy;
ione[1][2] -= massone * dy*dz;
ione[0][2] -= massone * dx*dz;
这正是惯量张量定义 的逐分量展开,最后通过 MPI_Allreduce 汇总各进程的局部累加结果,保证并行环境下结果正确。
自旋项:Group::inertia_extended() 与平行轴定理
Group::inertia_extended()(group.cpp)负责叠加有限尺寸粒子的“自旋(self)”惯量。它对不同粒子样式分支处理(见 add_extended_inertia 辅助函数,group.cpp):
- 有限尺寸球体(sphere):(源码中
SINERTIA * massone * radius^2,对角分量相同); - 椭球体 / 超椭球体(ellipsoid / superellipsoid):由存储的形状、四元数(quat)旋转主轴惯量到空间坐标系(超椭球体读取
bonus_super中逐粒子存储的主轴惯量); - 线段(line):按长度与朝向计算;
- 三角形(tri):按存储的惯量与四元数旋转;
- body 粒子(body/nparticle 等):使用每个粒子存储的惯量,通过四元数旋转到空间坐标系。
源码注释明确说明:普通球体、椭球体、线段、三角形与 fix rigid 命令的处理方式一致;而超椭球体和 body 粒子使用逐粒子存储的惯量,这两类粒子本身不被 fix rigid 支持。同时,自旋项不依赖质心位置,是叠加在轨道项之上的可加项。
需要指出的是,源码中的检查顺序有讲究:椭球体/超椭球体/三角形/body 粒子也带有(包围盒)半径,因此必须先检查形状类 bonus 索引,最后才进入球体(半径)分支,避免把有限形状粒子误当作球体处理。
KOKKOS 加速变体与并行实现
该命令提供 KOKKOS 加速变体 inertia/kk(以及 inertia/kk/device、inertia/kk/host),声明于 compute_inertia_kokkos.h。使用方式与普通加速样式一致,例如:
suffix kk
compute 1 molecule inertia
KOKKOS 版本在设备端计算轨道项(groupKK->inertia_kk<DeviceType>()),但当系统存在有限尺寸粒子(radius_flag、ellipsoid_flag、line_flag、tri_flag、body_flag 任一为真)时,会将相关数组同步回 Host,通过普通的 group->inertia_extended() 叠加自旋项(compute_inertia_kokkos.cpp)。这是为了保证半径、ellipsoid/line/tri/body 的 bonus 数组(无设备端副本)读取正确;对于纯点粒子系统则全程留在设备端,避免不必要的内存同步开销。
典型应用场景与实战示例
结合 thermo 输出转动惯量与转动动能
在刚体/有限尺寸粒子模拟中,常需要同时监控惯量张量与角速度来评估转动动能。examples/PACKAGES/addtorque_group/in.addtorque 提供了完整范例(in.addtorque):
compute 1 all chunk/atom molecule
compute 2 ball omega/chunk 1
compute 3 ball inertia/chunk 1
# 转动动能:1/2 * I * omega^2
variable r_ke_x equal c_2[1][1]*c_2[1][1]*c_3[1][1]*0.5
variable r_ke_y equal c_2[1][2]*c_2[1][2]*c_3[1][2]*0.5
variable r_ke_z equal c_2[1][3]*c_2[1][3]*c_3[1][3]*0.5
thermo_style custom step ke pe c_3[1][1] c_3[1][2] c_3[1][3] c_2[1][1] c_2[1][2] c_2[1][3] v_r_ke_x v_r_ke_y v_r_ke_z
thermo 500
该示例用 inertia/chunk 计算每个分子 chunk 的惯量分量,再结合角速度计算各轴转动动能,并通过 thermo_style custom 周期性输出。作为全局向量,compute inertia 的输出可同样通过 c_ID[1..6] 直接放入 thermo_style custom 或 fix ave/time 等命令。
通过 variable 的 inertia() 函数实时获取分量
除了显式定义 compute,LAMMPS 的 variable 命令还提供 inertia(group,dimdim) 组函数,返回该组惯量张量的 6 个分量之一,顺序同样是 Ixx, Iyy, Izz, Ixy, Iyz, Ixz。用法示例:
variable ixx equal inertia(all,xx)
variable ixy equal inertia(all,xy)
从源码注释看,inertia() 变量函数与 compute inertia 共享同一条代码路径(Group::inertia + Group::inertia_extended),因此两者结果完全一致。此外 inertia(group,dimdim,region) 变体还支持限定在某个 region 内计算,对应 Group::inertia(..., Region *) 的重载实现(group.cpp)。
单元测试与结果验证
仓库的单元测试为本文所述行为提供了直接验证:
- 解析式验证:test_compute_global.cpp 中的
ComputeInertiaTest构建小型独立系统(两个有限尺寸椭球体),与解析结果对比,验证compute inertia输出 、、(交叉项为 0),同时验证inertia()变量函数与 compute 共享代码路径、结果一致; - body 粒子分支:单个 body/nparticle 粒子位于原点、已知对角惯量张量 (2,3,4),验证
compute inertia原样返回; - 超椭球体分支:默认 blockiness (2,2) 下超椭球体退化为椭球体,验证
bonus_super分支解析结果一致; - 组级直接验证:test_groups.cpp 的
InertiaEllipsoid等测试直接调用Group::inertia()与Group::inertia_extended()校验有限尺寸粒子贡献,并测试 region 重载; - 自动化回归:compute-inertia.yaml 以 27 个球粒子系统(含 18 直径为 5.0、2027 直径为 0.0 的配置)记录了参考输出向量(6 个分量),用于跨版本回归比对,验证球体自旋惯量贡献。
这些测试的解析值可用于读者自查:当你的系统只有点粒子或简单球体时,可以手工计算惯量张量并与 compute inertia 输出对比,确认设置(尤其是 image flag)正确。
相关命令与注意事项
与该命令相关的其他命令包括:
- compute inertia/chunk:按 chunk(如分子)分别输出惯量张量数组;
- compute gyration:计算回转半径(gyration radius),惯量张量与之密切相关;
- variable inertia() 函数:以变量函数形式实时获取组惯量分量。
限制:文档明确说明该命令无特殊限制(Restrictions: none),可用于任意原子样式、任意单位与任意组。
使用建议:
- 若系统跨周期边界较大或原子分布接近边界,务必确认 image flag 正确(通常由
read_data、create_atoms等自动维护),必要时用set image重置后再调用该 compute; - 若只关心质心附近的轨道贡献而不关心粒子自身形状(如去除整体平动旋转),注意底层存在“轨道项”与“自旋项”的区分——诊断类命令(compute inertia、compute inertia/chunk、inertia() 变量)报告的是二者之和,而物理上用于去除体旋转的速度修正例程(如 fix momentum、velocity zero angular)只使用轨道惯量,参见 group.cpp 的注释说明;
- 在 GPU/KOKKOS 平台运行包含有限尺寸粒子的系统时,
inertia/kk会自动在设备与主机间同步必要数据,结果与普通版本一致(在容差范围内)。