LAMMPS compute inertia 命令详解:计算原子组相对质心的惯量张量

原创2026-10-14 18:24:471,885 阅读
文章标签:科学计算高性能计算科研

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 计算的是原子组中所有原子相对组质心 rcm\mathbf{r}_{\text{cm}} 的对称惯量张量:

I=∑i[mi((ri−rcm)21−(ri−rcm)⊗(ri−rcm))+Ii]I = \sum_i \left[ m_i \left( (r_i - r_{\text{cm}})^2 \mathbf{1} - (r_i - r_{\text{cm}}) \otimes (r_i - r_{\text{cm}}) \right) + I_i \right]

其中:

  • rcm\mathbf{r}_{\text{cm}} 是原子组的质心位置;
  • 求和覆盖组内所有原子 ii;
  • mim_i 是原子 ii 的质量(对每个原子独立质量 rmass 与按类型质量 mass 的原子样式分别取 rmass[i] 或 mass[type[i]]);
  • IiI_i 是原子 ii 相对自身中心的惯量。对于点粒子 Ii=0I_i = 0;对于有限尺寸粒子(finite-size particles,见 Howto_spherical),IiI_i 为粒子形状自身的惯量,并通过平行轴定理叠加到轨道项上。

该张量在源代码中通过两项叠加实现(详见下文“源码级实现”一节):轨道项由 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 IxxI_{xx} 绕 x 轴分量
2 IyyI_{yy} 绕 y 轴分量
3 IzzI_{zz} 绕 z 轴分量
4 IxyI_{xy} x-y 平面交叉项
5 IyzI_{yz} y-z 平面交叉项
6 IxzI_{xz} x-z 平面交叉项

该顺序由源码直接确定:compute_inertia.cpp 中将 3×3 对称张量的对应元素依次写入 vector[0..5]。由于张量对称,Iyx=IxyI_{yx}=I_{xy}、Izy=IyzI_{zy}=I_{yz}、Izx=IxzI_{zx}=I_{xz} 不会重复输出。

这些值可以被任何接受 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):

  1. 记录 invoked_vector = update->ntimestep(当前时间步,用于缓存判断);
  2. 若组是动态组(group->dynamic[igroup] 为真),重新计算 masstotal;
  3. group->xcm(igroup, masstotal, xcm) 计算组质心;
  4. group->inertia(igroup, xcm, itensor) 计算轨道项;
  5. 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;

这正是惯量张量定义 ∑m(r21−r⊗r)\sum m(r^2\mathbf{1} - r\otimes r) 的逐分量展开,最后通过 MPI_Allreduce 汇总各进程的局部累加结果,保证并行环境下结果正确。

自旋项:Group::inertia_extended() 与平行轴定理

Group::inertia_extended()(group.cpp)负责叠加有限尺寸粒子的“自旋(self)”惯量。它对不同粒子样式分支处理(见 add_extended_inertia 辅助函数,group.cpp):

  • 有限尺寸球体(sphere):I=25mr2I = \frac{2}{5} m r^2(源码中 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)。

单元测试与结果验证

仓库的单元测试为本文所述行为提供了直接验证:

  1. 解析式验证:test_compute_global.cpp 中的 ComputeInertiaTest 构建小型独立系统(两个有限尺寸椭球体),与解析结果对比,验证 compute inertia 输出 Ixx=10.4I_{xx}=10.4、Iyy=26.75I_{yy}=26.75、Izz=22.75I_{zz}=22.75(交叉项为 0),同时验证 inertia() 变量函数与 compute 共享代码路径、结果一致;
  2. body 粒子分支:单个 body/nparticle 粒子位于原点、已知对角惯量张量 (2,3,4),验证 compute inertia 原样返回;
  3. 超椭球体分支:默认 blockiness (2,2) 下超椭球体退化为椭球体,验证 bonus_super 分支解析结果一致;
  4. 组级直接验证:test_groups.cpp 的 InertiaEllipsoid 等测试直接调用 Group::inertia() 与 Group::inertia_extended() 校验有限尺寸粒子贡献,并测试 region 重载;
  5. 自动化回归:compute-inertia.yaml 以 27 个球粒子系统(含 18 直径为 5.0、2027 直径为 0.0 的配置)记录了参考输出向量(6 个分量),用于跨版本回归比对,验证球体自旋惯量贡献。

这些测试的解析值可用于读者自查:当你的系统只有点粒子或简单球体时,可以手工计算惯量张量并与 compute inertia 输出对比,确认设置(尤其是 image flag)正确。

相关命令与注意事项

与该命令相关的其他命令包括:

限制:文档明确说明该命令无特殊限制(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 会自动在设备与主机间同步必要数据,结果与普通版本一致(在容差范围内)。
登录后查看全文
lammps