LAMMPS compute angmom/chunk 命令详解:逐 chunk 计算角动量向量
LAMMPS compute angmom/chunk 命令详解:逐 chunk 计算角动量向量
本文以 LAMMPS 官方文档 compute_angmom_chunk.rst 为主体,结合源码 compute_angmom_chunk.cpp 与单元测试实现,系统讲解 compute angmom/chunk 的语法、物理含义、底层算法、周期性边界处理、有限尺寸粒子的自旋角动量支持,以及通过 fix ave/time 将逐 chunk 角动量写入文件的完整实操方案。读完本文,你将能够在分子、空间 bin、团簇等任意 chunk 划分方式下正确计算并输出每个 chunk 绕其质心的三轴角动量。
命令语法与基本示例
compute angmom/chunk 用于计算多个 chunk(原子集合)的角动量,其完整语法为:
compute ID group-ID angmom/chunk chunkID
- ID:compute 的标识符,由用户在输入脚本中自定义;
- group-ID:参与计算的原子组。ID 与 group-ID 的通用说明见 compute 命令文档;
- angmom/chunk:该 compute 的样式名;
- chunkID:由 compute chunk/atom 命令创建的 chunk 计算的 ID。
官方示例:
compute 1 fluid angmom/chunk molchunk
该命令定义的计算会输出一个全局数组(global array):行数等于 compute chunk/atom 计算出的 chunk 总数 Nchunk,列数固定为 3,分别对应每个 chunk 角动量向量的 (x, y, z) 三个分量。任何接受全局数组作为输入的命令都可以访问这些值。
理解 chunk:compute chunk/atom 是前提
在 LAMMPS 中,chunk 是由 compute chunk/atom 命令定义的原子集合,该命令把每个原子分配到唯一的 chunk ID(或不分到任何 chunk)。compute angmom/chunk 的 chunkID 参数正是引用这个 chunk 计算。常见的 chunk 划分方式包括:
| 划分维度 | 说明 |
|---|---|
molecule |
同一分子内的原子共享分子 ID 作为 chunk ID |
bin/1d、bin/2d、bin/3d |
按空间薄片/棱柱/立方盒子划分空间 bin |
bin/sphere、bin/cylinder |
球壳或圆柱形空间 bin |
type |
相同原子类型的原子归入同一 chunk |
c_cluster 等 per-atom compute 输出 |
以其他 compute/fix/变量的 per-atom 值作为 chunk ID |
例如,一个 chunk 可以是某个分子的所有原子,也可以是某个空间 bin 内的原子。如何定义 chunk、以及如何用 chunk 测量体系性质的大量示例,详见 Howto chunk 指南。
从源码结构上看,所有 /chunk 风格的 compute 都继承自公共基类 ComputeChunk(见 compute_chunk.h)。基类的 compute_array() 会先调用 cchunk->setup_chunks() 获取当前 chunk 总数 nchunk,再调用 cchunk->compute_ichunk() 得到每个原子的 ichunk 索引(值域为 1 到 Nchunk,未归属原子的值为 0),最后在 nchunk > maxchunk 时触发 allocate() 动态扩容(见 compute_chunk.cpp)。compute angmom/chunk 正是沿这条公共链路工作的。
物理定义与底层算法
compute angmom/chunk 计算的是每个 chunk 中单个原子的速度/动量相对该 chunk 质心(center-of-mass)的角动量的 3 个分量之和。也就是说,对第 k 个 chunk:
L_k = Σ_i m_i ( r_i − R_k ) × v_i
其中 R_k 为该 chunk 的质心位置,求和遍历该 chunk 内所有属于指定 group 的原子。
源码中的两步实现
源码 compute_angmom_chunk.cpp 将计算分为两个明确的阶段:
第一步:计算每个 chunk 的质心。 遍历本进程持有的局域原子(nlocal),对属于本 compute group 且 ichunk[i] >= 1 的原子,累加其质量(优先使用 per-atom 质量 rmass,否则使用按类型索引的 mass[type[i]])与"解缠绕"坐标加权和,得到 massproc 与 com;随后通过 MPI_Allreduce 汇总为全局的 masstotal 与 comall,再除以总质量得到每个 chunk 的质心 comall[i]。这意味着并行 MPI 环境下各进程的局域贡献会先归约再归一化,保证结果与进程划分无关。
第二步:累加角动量。 再次遍历局域原子,对每个原子计算:
dx = unwrap[0] - comall[index][0];
dy = unwrap[1] - comall[index][1];
dz = unwrap[2] - comall[index][2];
angmom[index][0] += massone * (dy * vunwrap[2] - dz * vunwrap[1]);
angmom[index][1] += massone * (dz * vunwrap[0] - dx * vunwrap[2]);
angmom[index][2] += massone * (dx * vunwrap[1] - dy * vunwrap[0]);
可见其核心正是 L = Σ m (r − R) × v 的叉积展开式(compute_angmom_chunk.cpp)。最后再次通过 MPI_Allreduce 将各进程的 angmom 归约为 angmomall,并把它作为该 compute 暴露给外部的全局数组(array = angmomall,见 compute_angmom_chunk.cpp)。
在内存管理上,massproc/masstotal、com/comall、angmom/angmomall 六组数组均由 allocate() 按 maxchunk 动态分配,memory_usage() 会向 LAMMPS 报告其占用(compute_angmom_chunk.cpp)。从这些实现细节可以推断:该计算对每个时间步需要两轮全局限归(质心一轮、角动量一轮),在大规模并行下的通信开销与 chunk 数量成正比。
周期性边界与 unwrapped 坐标
该计算包含原子穿越周期性边界时带来的全部效应。在实现上,原子坐标与速度都先经过 domain->unmap() 转换为"解缠绕(unwrapped)"形式(见 compute_angmom_chunk.cpp),即利用每个原子的镜像标志(image flags)还原其真实坐标,从而避免原子跨边界后坐标跳变导致角动量计算错误。
- 关于 unwrapped 坐标的讨论见 dump custom 命令文档;
- 关于 image flags 及其设置方式见 read_data 命令文档 的 Atoms 一节;
- 如果希望在调用本 compute 前重置 image flags(例如全部置 0),可使用 set 命令。
组(group)过滤规则
只有属于本 compute 指定 group 的原子才参与计算。compute chunk/atom 定义了自己的 group:不属于该 group 的原子其 chunk ID = 0,表示未归属到任何 chunk,因此也不会进入本计算。若你只想包含 chunk ID 非零的原子,可以直接为本 compute 指定 "all" group,例如:
compute cc1 all chunk/atom molecule
compute myChunk all angmom/chunk cc1
有限尺寸粒子的自旋角动量(2Sep2026 版本新增)
自 2Sep2026 版本起,本计算对有限尺寸粒子(见 Howto spherical 指南)新增了固有(自旋)角动量的贡献;在此之前所有原子一律按质点(point mass)处理。具体规则在源码 compute_angmom_chunk.cpp 中体现为按粒子类型分派:
| 粒子类型 | 处理方式 | 公式/数据来源 |
|---|---|---|
| sphere(球) | 由角速度与转动惯量计算 | L = I·ω,其中 I = 0.4 · m · r²(SINERTIA = 0.4,见 compute_angmom_chunk.cpp) |
| line(线段,2d) | 由角速度与转动惯量计算 | L = I·ω,其中 I = (1/12) · m · length²(LINERTIA = 1.0/12.0,见 compute_angmom_chunk.cpp) |
| ellipsoid / superellipsoid | 直接累加存储的 per-particle 角动量 | atom->angmom[i] |
| triangle(三角片) | 直接累加存储的 per-particle 角动量 | atom->angmom[i] |
| body(体粒子) | 直接累加存储的 per-particle 角动量 | atom->angmom[i] |
实现上的细节值得注意:源码先通过 dynamic_cast 匹配当前 atom_style(ellipsoid、line、tri、body),再检查每个原子的形状索引(ellipsoid[i] >= 0 等);形状索引的检查排在球(radius)分支之前,因为有限形状粒子同样携带半径,必须先排除它们才轮到普通的球/质点情形。这与 Howto spherical 指南 中"sphere/ellipsoid/line/tri/body 等原子样式"的划分一一对应。
测试用例验证
单元测试 test_compute_chunk.cpp 专门为这一新增行为提供了两个可复现的验证场景:
Sphere 测试:两个半径为 1、质量为 1 的球静止于 (0,0,0) 与 (2,0,0),仅设置角速度 omega = (0,0,5),预期整个 chunk 的总角动量为纯自旋贡献 (0, 0, 4):
units lj
atom_style sphere
create_box 1 box
create_atoms 1 single 0.0 0.0 0.0 units box
create_atoms 1 single 2.0 0.0 0.0 units box
set group all diameter 2.0
set group all mass 1.0
set group all omega 0.0 0.0 5.0
pair_style zero 5.0
compute ch all chunk/atom type
compute acc all angmom/chunk ch
fix h all ave/time 1 1 1 c_acc[*] mode vector
run 0 post no
Ellipsoid 测试:单个静止椭球(shape 2.0 4.0 6.0,mass 1.0)设置 angmom = (1,2,3),预期 chunk 角动量原样返回 (1, 2, 3)。
此外,compute-angmom_chunk.yaml 是 force-style 测试框架中的参考数据文件:它基于 in.fourmol(unittest/commands/in.fourmol)四分子体系,通过 compute molchunk all chunk/atom molecule 与 compute test all angmom/chunk molchunk 计算,并给出 6 个分子 chunk 各分量的期望数值(如第 6 行 7.6786214047209461e-03 -3.0307376254564145e-03 7.4112490031486107e-03),可作为自建输入脚本数值正确性的对照基准。
输出信息:全局数组的维度与单位
- 该 compute 计算一个全局数组,行数 = chunk 总数
Nchunk(由compute chunk/atom计算得出),列数 = 3,对应每个 chunk 的 (x, y, z) 角动量分量; - 数组值是 intensive(非广延量,不需要按进程数或原子数归一);
- 数值单位为 mass-velocity-distance(质量·速度·距离),具体量纲取决于 units 命令 的设置,例如
real单位下为 gram·Å·(Å/fs) 量纲的组合。
任何需要全局数组输入的命令都可以消费这些值;LAMMPS 输出选项的整体概览见 Howto output 指南。
实战:用 fix ave/time 将角动量写入文件
最简便的批量输出方式是结合 fix ave/time,官方示例为:
compute cc1 all chunk/atom molecule
compute myChunk all angmom/chunk cc1
fix 1 all ave/time 100 1 100 c_myChunk[*] file tmp.out mode vector
拆解这条链路:
compute cc1 all chunk/atom molecule:以分子为单位划分 chunk;compute myChunk all angmom/chunk cc1:计算每个分子的角动量向量;fix 1 all ave/time 100 1 100 c_myChunk<a href="https://link.gitcode.com/i/0e5d417647e46aa2721c8848790371aa" target="_blank">*] ... mode vector:每 100 步采样 1 次、共采 100 个样本后,把c_myChunk[*]的全部 3 列写入tmp.out。mode vector指定按向量模式输出整个数组,配合c_myChunk[*]的星号通配即可把Nchunk × 3的全局数组逐行落盘(关于fix ave/time的mode、file等关键字细节见 [fix_ave_time.rst)。
相关命令与限制
- 相关命令:
variable的 group 函数 angmom() 可计算单个 group(而非逐 chunk)绕质心的角动量分量;自 2Sep2026 起该函数同样纳入了有限尺寸粒子的贡献。二者在"单 chunk 即整个 group"的场景下可互为验证。 - 限制(Restrictions):无。
- 默认值(Default):无。
小结
compute angmom/chunk 是 LAMMPS chunk 计算家族(angmom、com、gyration、inertia、omega、torque、vcm 等,完整清单见 Howto chunk 指南)中专门面向角动量的成员。它把"按分子/空间 bin/团簇等任意划分方式统计体系转动特性"这一常见分析需求封装为两轮归约的并行算法,并正确处理了周期性边界与(2Sep2026 起)有限尺寸粒子的自旋贡献。配合 fix ave/time 即可稳定地输出逐 chunk 角动量轨迹,是研究分子转动、团簇自旋、颗粒流等体系的有力工具。