LAMMPS compute temp/chunk 命令详解:按块(chunk)计算温度与动能

原创2026-10-14 17:56:261,880 阅读
文章标签:科学计算高性能计算科研

LAMMPS compute temp/chunk 命令详解:按块(chunk)计算温度与动能

compute temp/chunk 是 LAMMPS 中用于"按块(chunk)统计热力学量"的核心命令:它把一个 group 中的原子按 compute chunk/atom 划分成多个 chunk(如分子、空间条带/柱、按类型分组等),并计算整个 group 的全局温度、6 分量动能张量,以及可选地输出每个 chunk 的温度、质心动能和内部动能。读完本文你将掌握该命令的完整语法、DOF(自由度)公式与 adof/cdof 的调参方法、com/bias 速度偏置扣除机制,并能结合 fix ave/time 输出每个 chunk 的温度剖面。本文基于 compute_temp_chunk.rst 文档,并结合 compute_temp_chunk.cpp 源码与仓库测试用例展开说明。

语法与参数总览

compute ID group-ID temp/chunk chunkID value1 value2 ... keyword value ...
  • ID、group-ID:与其他 compute 命令一致;
  • temp/chunk:本命令的 style 名称;
  • chunkID:一个 compute chunk/atom 命令的 ID,负责把每个原子分配到某个 chunk(或分配 0 表示不属于任何 chunk);
  • value:零个或多个可选值,取 temp、kecom、internal 之一;
  • keyword:零个或多个键值对,取 com、bias、adof、cdof 之一。

文档中的典型示例:

compute 1 fluid temp/chunk molchunk
compute 1 fluid temp/chunk molchunk temp internal
compute 1 fluid temp/chunk molchunk bias tpartial adof 2.0

第 2 条同时输出每个 chunk 的温度和内部动能;第 3 条则把 tpartial(一个温度 compute)作为速度偏置移除,并将每原子 DOF 设为 2.0。

它计算什么:全局温度、动能张量与按 chunk 的量

该 compute 的核心任务是:对一组原子(同时属于指定 group 与某个 chunk),可选地扣除每个 chunk 的质心速度后计算温度。一个 chunk 可以是"一个分子"或"一个空间 bin"等,其定义方式详见 compute chunk/atom 与 Howto chunk。

全局温度与 DOF 公式

全局温度由经典关系

KE = (DOF / 2) * kB * T

给出,其中 KE 是所有被分配到 chunk 的原子动能之和(Σ ½ m v²),DOF 是这些原子的总自由度,kB 为玻尔兹曼常数,T 为绝对温度。DOF 计算为:

DOF = N * adof + Nchunk * cdof

其中 N 是贡献动能的原子数,adof 是每原子自由度(默认取 dimension 命令设定的维度 2 或 3),cdof 是每 chunk 自由度(默认 0.0)。这就是普通温度公式。

从源码 compute_temp_chunk.cpp 可以看到该公式的实现:构造函数中默认 adof = domain->dimension; cdof = 0.0;(L72-L73),而 compute_scalar() 最终换算因子为 tfactor = mvv2e / (dof * boltz),即把动能求和换算为温度(L262-L266),并针对 dof < 0 且存在原子贡献的情形直接报错(L265)。

6 分量对称动能张量

除全局标量外,本 compute 还输出一个 6 元素对称张量向量:公式与动能表达式相同,但不含 1/2 因子,且把 v² 替换为相应的叉积分量(xy 分量对应 vx·vy,等等)。因此这些张量分量为传统动能张量的两倍。六个分量的顺序为 xx、yy、zz、xy、xz、yz。源码中 compute_vector()(L272-L349)正是按 t[0]…t[5] 累加这些交叉项,最终乘以 mvv2e 换算成能量单位。

参与原子数动态统计

与 compute temp 不同,本命令每次求值时都会重新统计贡献原子数(原子可能被动态分配到 chunk),因此无需为它使用 compute_modify 的 dynamic 选项。这与 compute temp 中"参与原子数假定恒定、需要 dynamic 选项"的说明形成鲜明对比。

三个可选 value:temp / kecom / internal

指定任意一个可选 value 后,compute 会额外输出一个全局数组,行数等于 compute chunk/atom 计算出的 chunk 数 Nchunk,列数等于指定 value 的个数(≥1)。

  • temp:按同样公式计算每个 chunk 的温度。此时 DOF 为 N * adof + cdof(注意:这里只有单个 cdof 加项,没有 Nchunk 因子),其中 N 为该 chunk 的原子数。
  • kecom:把每个 chunk 内所有原子视为以该 chunk 质心速度整体运动,计算这个"整体动能"。
  • internal:计算每个 chunk 的内部动能:先对每个原子求"热速度"(原子速度减去该 chunk 质心速度),再累加动能。

这三个值的换算在源码 compute_array()(L353-L385)中分发到 temperature()、kecom()、internal() 三个私有方法:kecom 与 internal 均以 0.5 * mvv2e * sumall[i] 输出能量(L583、L637),temperature 则以 mvv2e / (dof * boltz) 输出温度(L524-L531)。

值得注意的实现细节:vcm_compute()(L391-L440)先累加每个 chunk 的动量与质量,再经 MPI_Allreduce 汇总、除以总质量得到每个 chunk 的质心速度 vcmall;并且 comstep 记录时间步,避免同一时间步重复计算 VCM(L396-L398)。这正是 kecom/internal 与 com 选项共用同一套质心速度基础设施的原因。

输出信息与单位

  • 全局标量:温度(intensive,强度量),温度单位;
  • 全局向量:6 分量动能张量(extensive,广延量),能量单位,可通过索引 1–6 访问;
  • 全局数组(指定了可选 value 时才有):每行一个 chunk,列数为 value 个数;temp 列为温度单位,kecom/internal 列为能量单位,均为 intensive;
  • 这些输出可被任何接受 compute 全局标量/向量/数组的命令消费,详见 Howto output。

官方推荐的输出方式是配合 fix ave/time 写入文件,例如:

compute cc1 all chunk/atom molecule
compute myChunk all temp/chunk cc1 temp
fix 1 all ave/time 100 1 100 c_myChunk[1] file tmp.out mode vector

仓库的单元测试 compute-temp_chunk.yaml 即按此模式验证:先定义 compute molchunk all chunk/atom molecule,再定义 compute test all temp/chunk molchunk temp,随后对 global_scalar、global_vector(6 分量张量)和 global_array(每 chunk 温度)给出精确数值断言;test_compute_chunk.cpp 中的 ChunkComputes 用例也测试了 compute tmp all temp/chunk mols com yes 与 fix ave/time 的组合输出。

四个 keyword 详解

com yes/no:扣除每个 chunk 的质心速度

com yes 会在计算全局或按 chunk 温度之前,把每个 chunk 的质心速度(VCM)从该 chunk 内原子速度中减去。当原子整体流动或集体运动时,用它可以得到纯粹的"热温度"。该逐 chunk 的 VCM 偏置还可被其他支持温度偏置的 fix/compute 复用:

  • 恒温器类:fix nvt、fix temp/rescale、fix temp/berendsen、fix langevin(见 fix_nh、fix_temp_rescale、fix_temp_berendsen、fix_langevin);
  • 应力类:compute stress/atom(通过 temp-ID 消费本 compute 的偏置速度)、compute pressure。

源码中 tempflag = 1 且 comflag 置位时 tempbias = 1(L42、L113),并通过 remove_bias()/restore_bias() 系列方法(L648-L716)向恒温器暴露"扣偏置—作用—回加偏置"的标准接口。

仓库自带的实战示例 in.stress_vcm 完整演示了这条链路:先把盒子沿 x 方向切成 20 个等距 bin,再用 com yes 计算带 VCM 扣除的逐 bin 温度,进而用 compute stress/atom 得到扣除刚体运动后的逐原子应力,最后经 fix ave/time 输出应力剖面:

compute ch_id all chunk/atom bin/1d x lower ${fraction} units reduced
compute ch_temp_vcm all temp/chunk ch_id com yes
compute atom_stress_vcm all stress/atom ch_temp_vcm
fix ave_stress_vcm all ave/time 5 20 100 c_ch_stress_vcm mode vector file stress_xx.out

bias bias-ID:叠加外部速度偏置

bias-ID 是另一个能移除速度偏置的温度 compute 的 ID。它同样允许只使用"热速度"计算全局或按 chunk 温度(例如移除速度剖面),并且同样作用于 kecom/internal:此时每个 chunk 的质心速度是在速度偏置移除之后计算的。需要注意:该温度 compute 的偏置是全局施加的,而不是逐 chunk 施加。实现上,biasflag 分支会在求值前调用 tbias->remove_bias_all()、结束后 restore_bias_all()(如 L183-L186、L253),并对 bias compute 的合法性做检查:必须存在、必须是温度 compute、必须具有速度偏置能力(L100-L106)。

adof / cdof:手工调整自由度

adof(每原子 DOF)与 cdof(每 chunk DOF)用于对某些特殊 chunk 得到更合理的温度。文档给出三个典型场景:

  1. 空间 bin 内包含若干水分子且用 fix shake 约束为刚体:每个分子 6 个 DOF(3 平动 + 3 转动),可设 adof 2.0;
  2. 用 compute temp/partial 作 bias,只允许 x 方向速度贡献:设 adof 1.0;
  3. 每个 chunk 是一个大分子,部分键被 fix shake 约束或整体被 fix rigid/small 约束:设 adof 0.0,并把 cdof 设为整个分子剩余 DOF(3d 情形刚体分子为 6,2d 为 3)。

adof/cdof 在构造时经 utils::numeric 解析(L86-L93),默认值即 adof = 维度、cdof = 0.0。在 temperature() 中每个 chunk 的 DOF 为 cdof + adof * countall[i](L525)。

注意事项与适用范围

  • 只包含平移自由度:目前全局与按 chunk 温度均只含每原子平移 DOF,不含有限尺寸粒子的转动 DOF;也不会为 compute temp/partial、fix shake、fix rigid 等施加的约束自动扣除 DOF,因为约束可能同时跨越 chunk 内外的原子,概念上难以定义。此时应借助 adof/cdof 手动修正。
  • 只统计 group 内原子:compute chunk/atom 有自己定义的 group;不在其 group 的原子 chunk ID = 0,也不参与本计算。如果想只按 chunk 归属统计,可对本命令指定 all group。
  • 与 fix ave/chunk temp 的区别:本 compute 对单个时间快照计算每个 chunk 的温度;fix ave/chunk temp(见 fix_ave_chunk.rst)既能做同样的事,也能跨多个快照做时间平均,甚至把不同时间步落在同一 chunk 的原子收集起来算温度;此外只有本 compute 支持先扣质心速度再算温度,fix ave/chunk 不支持。

限制与默认值

  • 限制:com 与 bias 两个 keyword 不能同时使用(源码 L111-L112 直接报错 "Cannot use both com and bias with compute temp/chunk")。
  • 默认值:com no、无 bias、adof = 系统维度(2 或 3,由 dimension 决定)、cdof 0.0。
  • 相关命令:compute temp、fix ave/chunk temp,以及 chunk 生态中的 compute chunk/atom。

源码结构速览

  • 类 ComputeTempChunk 继承自 ComputeChunk(compute_chunk.h),声明于 compute_temp_chunk.h,由 ComputeStyle(temp/chunk,ComputeTempChunk) 注册;
  • 关键私有成员:comflag、biasflag、adof、cdof、id_bias、tbias(bias compute 指针)、vcm/vcmall(每 chunk 质心速度)等;
  • 三个核心求值路径:compute_scalar()(全局温度)、compute_vector()(6 分量张量)、compute_array()(按 chunk 的 temp/kecom/internal);
  • 与恒温器的接口:remove_bias(_all) / restore_bias(_all) 四个方法,使本 compute 可作为温度偏置被 fix nvt、fix langevin 等消费;
  • 内存占用估算见 memory_usage()(L753-L763),按 maxchunk 线性增长。

对于需要"按分子/按空间 bin 监控温度分布、扣除刚体/质心运动后评估热力学量"的场景,compute temp/chunk 是首选的标准化工具——配合 com yes 处理流动体系、配合 adof/cdof 处理刚体约束体系,再经 fix ave/time 落盘输出,即可获得可直接用于分析的逐 chunk 温度与动能剖面。

登录后查看全文
lammps