LAMMPS Hugoniostat 冲击动力学模拟:fix nphug 命令全面解析与实战指南

原创2026-10-15 17:40:211,291 阅读
文章标签:科学计算高性能计算科研

LAMMPS Hugoniostat 冲击动力学模拟:fix nphug 命令全面解析与实战指南

导读

fix nphug 是 LAMMPS 中用于执行 Hugoniostat(雨果尼奥统计)时间积分的核心命令,它在 Nose-Hoover 恒压积分框架(fix npt)的基础上,将用户指定的目标温度替换为随时间变化的 Rankine-Hugoniot(RH)目标温度,从而把体系压缩到满足稳态冲击跳跃条件、且平均轴向应力/压力等于设定目标值的状态。本文基于 doc/src/fix_nphug.rst 官方文档,结合 src/SHOCK/fix_nphug.cpp 源码实现、src/SHOCK/fix_nphug.h 类定义、examples/PACKAGES/shock/hugoniostat/in.hugoniostat 完整算例与 unittest/force-styles/tests/fix-timestep-nphug.yaml 单元测试,系统讲解该命令的语法、全部关键字参数、Hugoniostat 方程、约束条件、内部实现原理与输出量,帮助你快速上手并深入理解其底层机制。


命令语法与关键字速查

fix nphug 的完整语法为:

fix ID group-ID nphug keyword value ...

其中 ID 和 group-ID 的规则与 fix 命令一致,其后可追加一个或多个 keyword value 键值对。支持的关键字如下表所示:

关键字 取值与含义
temp Value1 Value2 Tdamp:Nose-Hoover 目标温度(Hugoniostat 中 被忽略),Tdamp 为温度阻尼参数(时间单位)
iso / aniso / tri Pstart Pstop Pdamp:标量外部压力,Pstart 与 Pstop 必须相等;Pdamp 为压力阻尼参数(时间单位)
x / y / z / xy / yz / xz Pstart Pstop Pdamp:外部应力张量分量,Pstart 与 Pstop 必须相等;Pdamp 为应力阻尼参数(时间单位)
couple none / xyz / xy / yz / xz:压力耦合方式
tchain 恒温器(thermostat)链长度(1 = 单一恒温器)
pchain 恒压器(barostat)上的恒温器链长度(0 = 无恒温器)
mtk yes / no:是否加入 MTK 修正项
tloop 恒温器子循环次数
ploop 恒压器恒温器子循环次数
nreset 每隔多少时间步重置参考晶胞
drag 加入恒压器/恒温器的拖拽因子(0.0 = 无拖拽)
dilate all / partial:晶胞变化时如何缩放原子位置
scaleyz yes / no:是否用 lz 缩放 yz 倾斜因子
scalexz yes / no:是否用 lz 缩放 xz 倾斜因子
scalexy yes / no:是否用 ly 缩放 xy 倾斜因子

官方示例

fix myhug all nphug temp 1.0 1.0 10.0 z 40.0 40.0 70.0
fix myhug all nphug temp 1.0 1.0 10.0 iso 40.0 40.0 70.0 drag 200.0 tchain 1 pchain 0

第一个示例执行沿 z 轴的单轴压缩,目标轴向应力 40.0(约化单位);第二个示例执行静水压缩,并显式指定拖拽、恒温器与恒压器链参数。LAMMPS 的力风格单元测试 fix-timestep-nphug.yaml 中使用的写法与之同构:fix test all nphug temp 50.0 50.0 100.0 z 1000.0 1000.0 700.0,可见目标温度的两个值(此处均为 50.0)在语法上必须出现,但在物理上被 Hugoniostat 忽略。


物理背景:Hugoniostat 是什么

fix nphug 是 Nose-Hoover fix npt 风格的一个变体,执行由 Ravelo 等人提出的 Hugoniostat 运动方程的时间积分(见 fix_nphug.rst 文末引文:Ravelo, Holian, Germann and Lomdahl, Phys Rev B, 70, 014103 (2004))。这些方程将体系压缩到:

  1. 平均轴向应力或压力等于用户指定的目标值;
  2. 满足稳态冲击的 Rankine-Hugoniot(RH)跳跃条件。

压缩可以按两种方式进行:

  • 静水压缩(hydrostatic):使用 iso、aniso 或 tri 关键字。此时三个方向的晶胞尺寸动态变化,使三个方向的平均轴向应力都收敛到目标值。
  • 单轴压缩(uniaxial):使用 x、y 或 z 关键字。此时只有所选方向的晶胞尺寸动态变化,使该方向的平均轴向应力收敛到目标值,另外两个方向保持固定(零横向应变)。

目标温度方程

本质上,Hugoniostat 模拟就是一个 NPT 模拟,只是把用户指定的目标温度替换为随时间变化的目标温度 TtT_t:

Tt−T=(12(P+P0)(V0−V)+E0−E)NdofkB=ΔT_t - T = \frac{\left(\frac{1}{2}\left(P + P_0\right)\left(V_0 - V\right) + E_0 - E\right)}{N_{dof} k_B} = \Delta

其中各符号含义为:

  • TT、TtT_t:瞬时温度与目标温度;
  • PP、P0P_0:瞬时压力/轴向应力与参考压力/轴向应力(静水或单轴压缩时取相应含义);
  • VV、V0V_0:瞬时体积与参考体积;
  • EE、E0E_0:瞬时内能(势能加动能)与参考内能;
  • NdofN_{dof}:温度定义中使用的自由度数目;
  • kBk_B:玻尔兹曼常数;
  • Δ\Delta:瞬时温度对目标温度的负偏差。

当体系达到稳定平衡时,Δ\Delta 应在零附近波动。E0E_0、V0V_0、P0P_0 默认取模拟起始时刻的瞬时值,也可通过下述 fix_modify 的 e0、v0、p0 关键字覆盖。

源码中的实现对应

在 src/SHOCK/fix_nphug.cpp 中,目标温度与 Hugoniot 偏差由两个核心私有方法实现:

  • compute_temp_target():每步执行 t_target = t_current + compute_hugoniot(),即上式 Tt=T+ΔT_t = T + \Delta 的数值实现,并据此更新目标动能 ke_target = tdof * boltz * t_target;
  • compute_hugoniot():先取总能量 e = compute_etotal()(势能 compute 与温度 compute 之和),再根据单轴/静水模式取压力分量或标量,最后按公式计算 dhugo 并除以 tdof * boltz 得到温度单位的偏差。

同时,参考密度 rho0 在 setup() 中由 nktv2p * force->mvv2e * masstot / v0 计算,用于后续冲击波速度与粒子速度的计算。


Hugoniostat 模式下的关键字限制

由于 Hugoniostat 的物理约束,该命令对关键字施加了额外的限制(与 fix nphug 文档 一致):

  1. iso、aniso、tri、x、y、z 六个压力关键字必须且只能使用其中一个;
  2. 指定的初始与最终目标压力必须相同(Pstart 必须等于 Pstop);
  3. 关键字 xy、xz、yz 不允许使用(Hugoniostat 不支持剪切应力目标);
  4. couple 唯一允许的取值是 xyz,其效果等同于关键字 iso;
  5. temp 关键字必须使用(用于指定动能弛豫的时间常数),但其中的初始与最终目标温度值被忽略。

这些限制在构造函数中通过硬性检查强制执行。查看 src/SHOCK/fix_nphug.cpp 可以看到:

  • 若任一方向 p_start[i] != p_stop[i],直接报错 "Pstart and Pstop must have the same value";
  • pstyle == ISO 时为静水压缩(uniaxial = 0);
  • pstyle == ANISO 时,若三个目标压力相等则仍为各向同性静水压缩,若恰好只有一个方向 p_flag 为 1(如 x、y、z 单独出现)则为单轴压缩(uniaxial = 1 并记录 idir),否则报错 "Specified target stress must be uniaxial or hydrostatic";
  • pstyle == TRICLINIC 时,要求三个主压力相等且剪切分量为零,否则报错 "For triclinic deformation, specified target stress must be hydrostatic";
  • 若未开启温度控制(!tstat_flag)报错 "Temperature control must be used with fix nphug",未开启压力控制(!pstat_flag)报错 "Pressure control must be used with fix nphug"。这两条错误信息也记录在 doc/src/Errors_messages.rst 中。

从类设计看,src/SHOCK/fix_nphug.h 中 FixNPHug 直接继承 FixNH(#include "fix_nh.h"),并通过 FixStyle(nphug,FixNPHug) 注册到 LAMMPS 的 fix 工厂,因此它天然复用 fix npt 的全部 Nose-Hoover 参数解析、子循环与重启机制,仅在顶层改写目标温度计算与参考状态。


与其他时间积分 fix 的兼容性警告

fix nphug 与 fix temp/berendsen 有本质区别:后者只做恒温不做时间积分,而本 fix 同时执行恒温/恒压与时间积分。因此:

  • 不得再对同一批原子使用任何其他时间积分 fix,如 fix nve;
  • 不得用在温度已被其他 fix 控制的原子上,例如 fix langevin 或 fix temp/rescale。

内部温度/压力 compute 的创建与使用

该 fix 每一步都会计算温度和压力,为此它会在内部自行创建 temp 与 pressure 风格的 compute,等价于自动执行以下两组命令之一:

compute fix-ID_temp group-ID temp
compute fix-ID_press group-ID pressure fix-ID_temp

compute fix-ID_temp all temp
compute fix-ID_press all pressure fix-ID_temp

也就是说,新 compute 的 ID 为 fix-ID + 下划线 + "temp" 或 fix-ID + 下划线 + "press",且其 group 固定为 all(因为压力总是针对整个体系计算)。在 src/SHOCK/fix_nphug.cpp 构造函数中可看到实际的创建语句:

id_temp = utils::strdup(std::string(id)+"_temp");
modify->add_compute(fmt::format("{} all temp",id_temp));
id_press = utils::strdup(std::string(id)+"_press");
modify->add_compute(fmt::format("{} all pressure {}",id_press,id_temp));
id_pe = utils::strdup(std::string(id)+"_pe");
modify->add_compute(fmt::format("{} all pe",id_pe));

注意这里还额外创建了一个 势能 compute(fix-ID_pe,style pe),用于计算 Hugoniot 方程中的内能 EE。init() 中会校验该 compute 存在且 peflag != 0(即确实计算势能)。

关键区别:thermo_temp / thermo_press 不受影响

这些内部 compute 不是热力学输出(thermo_style)所用的 thermo_temp 与 thermo_press。因此:

  • 你可以通过 compute_modify 修改本 fix 温度/压力的属性;
  • 也可以借助 thermo_style custom 输出这些 compute 的值(用对应的 compute-ID 引用);
  • 反过来,修改 thermo_temp / thermo_press 的属性对本 fix 没有任何影响。

动能与维里的一致性

通过 fix_modify temp 和 press 选项,你可以给该 fix 指定自定义 compute 用于恒温/恒压过程。此时需注意:由温度 compute 推导的动能,应与用全部原子计算压力维里项保持一致;若对原子子集计算温度,LAMMPS 会给出警告。


加速变体 nphug/omp

文档明确标注该 fix 存在加速变体 nphug/omp(见 fix_nphug.rst 与 doc/src/accel_styles.rst)。带 gpu、intel、kk、omp、opt 后缀的样式与无后缀版本功能相同,只是针对相应硬件做了性能优化,接受相同参数、产生相同结果(仅存在舍入误差差异)。加速样式分别属于 GPU、INTEL、KOKKOS、OPENMP、OPT 包,只有在用这些包构建 LAMMPS 时才会启用。使用方式有三种:在输入脚本中显式写后缀(如 fix ... nphug/omp ...)、启动时用 -suffix 命令行开关、或脚本中使用 suffix 命令。从源码结构看,OPENMP 包中 src/OPENMP/fix_nh_omp.cpp 与 fix_nh_omp.h 提供了 Nose-Hoover 系列(含 nvt/nph/npt)的 OpenMP 并行 remap 实现,nphug/omp 即属于该家族。


重启、fix_modify、输出与运行控制

二进制重启

该 fix 会把 E0E_0、V0V_0、P0P_0 以及所有恒温器/恒压器变量的状态写入二进制重启文件。源码中 pack_restart_data() 先写入 e0、v0、p0 三个量,再调用基类 FixNH::pack_restart_data() 写入恒温器/恒压器状态;size_restart_global() 在基类基础上增加 3 个数据;restart() 则按相同顺序恢复并置位 e0_set/v0_set/p0_set。配合 read_restart 在输入脚本中重新指定该 fix,即可让计算无中断地继续运行。

fix_modify 关键字:e0 / v0 / p0

fix_modify 的 e0、v0、p0 关键字可用来显式定义参考内能、参考体积与参考压力:

  • e0、v0 是广延量(extensive),因此必须是对应整个体系的总能量与总体积,而非单原子或每原子值;
  • 若未指定,则取模拟开始时体系的瞬时值;
  • temp 与 press 选项同样受支持(见上文“内部温度/压力 compute”一节)。

源码中 modify_param() 对 e0、v0、p0 三个关键字逐一解析并置对应 *_set 标志;setup() 中只有在 *_set == 0 时才用瞬时值初始化:体积 v0 = compute_vol()(3D 为 xprd*yprd*zprd,2D 为 xprd*yprd),压力 p0 在单轴模式下取 p_current[idir]、静水模式下取三个方向压力平均,能量 e0 = compute_etotal()。

能量守恒与热力学输出

该 fix 造成的体系累计能量变化会体现在热力学输出(thermo_style)的 ecouple 与 econserve 关键字中。注意:这部分能量不计入上面 Hugoniot 方程中内能 EE 的定义。

标量与向量输出

该 fix 计算一个全局标量,可通过各种输出命令访问,其值为上述累计能量变化,量纲为广延量(extensive)。

该 fix 还计算一个全局向量(各元素为强度量,intensive),向量的组织方式(与 src/SHOCK/fix_nphug.cpp 的 compute_vector() 一一对应):

向量索引 物理量 含义
1(f_fix[1]) Δ\Delta 温度对目标温度的偏差(温度单位),即 Hugoniot 能量差
2(f_fix[2]) Us 冲击波速度(distance/time 单位)
3(f_fix[3]) up 粒子速度(distance/time 单位)
4 起 — fix npt 定义的所有内部 Nose/Hoover 恒温器与恒压器变量

源码实现中,向量长度通过在构造函数中 size_vector += 3 扩展基类向量,并关闭 deviatoric_flag、减去偏应力应变能对应的一项,因此 Hugoniostat 模式下不输出偏应力相关量。

Us 与 up 由 RH 条件推导,对应源码 compute_us() 与 compute_up():

Us2=P−P0ρ0 ε,ε=1−VV0,up=ε⋅UsUs^2 = \frac{P - P_0}{\rho_0 \, \varepsilon},\qquad \varepsilon = 1 - \frac{V}{V_0},\qquad up = \varepsilon \cdot Us

其中当压缩量 ε\varepsilon 过小(< 1e-10)或当前压力低于参考压力(p < p0)时,代码将 Us 置零以避免虚数根号。


完整实战算例:复现 Ravelo 等人 PRB 70 014103 (2004) 的应力轨迹

LAMMPS 在 examples/PACKAGES/shock/hugoniostat/in.hugoniostat 提供了完整的可运行算例,其目标正是复现 Ravelo, Holian, Germann 和 Lomdahl, Phys Rev B, 70, 014103 (2004) 图 1 中的应力轨迹。算例依次访问三种恒温方案:无阻尼(nodrag)、带阻尼(drag)与 Nose-Hoover 链(nhchains),并把轴向与剪切应力轨迹写入 stress_vs_t.dat。对应的参考运行日志可见 examples/PACKAGES/shock/hugoniostat/log.08Feb21.hugoniostat.g++.1(1 进程)与 .g++.4(4 进程)。

体系准备:沿 <110> 定向的 FCC 晶格

units           lj
boundary        p p p
atom_style      atomic

lattice         fcc 1.4142136 &
                orient x 0 0 1 &
                orient y 1 -1 0 &
                orient z 1 1 0

region          mycell block 0.0 5.0 0.0 5.0 0.0 5.0 units lattice
create_box      1 mycell
mass            * 1.0
create_atoms    1 box

pair_style      lj/cubic
pair_coeff      * * 1.0 0.8908987

该脚本还示范了两个技巧:如何沿 <110> 定向晶体,以及如何使用 lj/cubic 对势。随后用 fix box/relax 先弛豫盒子尺寸、minimize 做能量最小化、velocity create 0.01 87287 ... 赋予初速度并写入 restart.equil。

Run #1:无阻尼单轴 Hugoniostat(Pzz = 40.0)

clear
read_restart restart.equil
neighbor        0.2 bin
neigh_modify    every 1 delay 0 check yes
timestep        0.001
reset_timestep  0

fix myhug all nphug temp 1.0 1.0 10.0 z 40.0 40.0 70.0 drag 0.0 tchain 1 pchain 0

# 参考状态取自论文(乘以 1000 个原子)
fix_modify myhug e0 -6334.0 p0 0.0 v0 680.73519

variable dele  equal f_myhug[1]   # 能量偏差 [温度单位]
variable us    equal f_myhug[2]   # 冲击波速度 [距离/时间]
variable up    equal f_myhug[3]   # 粒子速度 [距离/时间]
variable pzz   equal pzz          # 轴向应力
variable tau   equal 0.5*(pzz-0.5*(pxx+pyy))   # 剪切应力
variable time  equal dt*step

thermo          1000
thermo_style    custom step temp ke epair econserve pzz v_tau lz f_myhug v_dele v_us v_up

fix stress all print 10 "${time} ${pzz} ${tau} " screen no append stress_vs_t.dat title '#time pzz tau (no drag)'

run 10000

Run #2 与 Run #3 与上面几乎相同,区别仅在于:Run #2 使用 drag 200.0(阻尼开启,且 Tdamp 改为 1.0);Run #3 使用默认 Nose-Hoover 链(直接省略 drag、tchain、pchain,即 temp 1.0 1.0 1.0 z 40.0 40.0 70.0)。

这个算例展示了几个关键实战要点:

  1. fix_modify myhug e0 ... v0 ... p0 ... 显式覆盖参考状态:e0 = -6334.0、v0 = 680.73519 是论文中对应 1000 原子体系的总能量与总体积,p0 = 0.0;
  2. 利用向量输出监视模拟质量:f_myhug[1](Δ\Delta,应围绕 0 波动)、f_myhug[2](Us)、f_myhug[3](up)直接出现在 thermo_style 中;
  3. econserve 与 epair 一并输出,用于核对能量守恒;
  4. 脚本对三次运行均使用 clear + read_restart restart.equil 从同一平衡构型出发,保证三组对比实验初始条件一致。

单元测试佐证

仓库的力风格回归测试 unittest/force-styles/tests/fix-timestep-nphug.yaml 为 fix nphug 提供了参考基准:它使用 atom full、fix test all nphug temp 50.0 50.0 100.0 z 1000.0 1000.0 700.0,在 in.fourmol 输入文件与 coeffs.fourmol 系数文件上以 epsilon = 2.5e-12 的精度比对全局标量、全局向量以及末帧位置/速度。这证明该 fix 的输出量(含向量前三个 Hugoniostat 专属量与后续 Nose/Hoover 变量)均有确定性基准可校验。


限制条件与包依赖

fix nphug 属于 SHOCK 包,只有在使用该包构建 LAMMPS 时才可用。构建方式:

SHOCK 包还包含冲击模拟家族的其他 fix:fix append/atoms、fix msst(多尺度冲击技术)与 fix wall/piston,详见 doc/src/Packages_details.rst 中 SHOCK 包一节;对应示例位于 examples/PACKAGES/shock(含 hugoniostat、msst、nemd 三个子目录)。

此外,fix npt 的所有常规限制同样适用,并叠加上文提到的 Hugoniostat 专属限制。例如:scaleyz yes/scalexz yes 不能用于 2D 模拟,倾斜因子缩放选项只能在对应方向周期且未通过 tri/yz/xz/xy 与恒压器耦合时使用;这些 fix 可用于动态 group,但恒温器/恒压器的守恒性质是针对原子数固定的体系定义的,原子数剧烈变化时可能出现异常行为。


相关命令与默认值

与 fix nphug 直接相关的命令:

  • fix msst:MSST 冲击动力学(同一 SHOCK 包内的另一条稳态冲击路径);
  • fix npt:本 fix 的基类 Nose-Hoover 恒压积分;
  • fix_modify:用于设置 e0/v0/p0 及替换温度/压力 compute。

fix nphug 的关键字默认值与 fix npt 完全相同(由基类 src/fix_nh.cpp 与 doc/src/fix_nh.rst 定义):tchain = 3、pchain = 3、mtk = yes、tloop = 1、ploop = 1、nreset = 0、drag = 0.0、dilate = all、couple = none、flip = yes;scaleyz = scalexz = scalexy = yes(当第二方向周期且未与恒压器耦合时),否则为 no。源码中 mtchain = mpchain = 3; nc_tchain = nc_pchain = 1; mtk_flag = 1; drag = 0.0; allremap = 1; nreset_h0 = 0; 与文档默认值一一对应。


小结

fix nphug 将 Nose-Hoover NPT 框架与 Rankine-Hugoniot 跳跃条件结合,为稳态冲击模拟提供了简洁的“单命令”方案:只需一条 fix 命令,即可在保持横向应变或实现静水压缩的同时,让体系沿 Hugoniot 曲线收敛到指定目标应力。理解其关键字约束、Δ\Delta 目标温度方程、三个专属输出量(Δ\Delta、Us、up)以及 e0/v0/p0 参考状态的作用,是正确使用并解读结果的关键;examples/PACKAGES/shock/hugoniostat/in.hugoniostat 是直接可复现的权威模板,src/SHOCK/fix_nphug.cpp 则提供了每一步公式的数值实现细节,可供深入研究者进一步对照。

登录后查看全文
lammps