LAMMPS Hugoniostat 冲击动力学模拟:fix nphug 命令全面解析与实战指南
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))。这些方程将体系压缩到:
- 平均轴向应力或压力等于用户指定的目标值;
- 满足稳态冲击的 Rankine-Hugoniot(RH)跳跃条件。
压缩可以按两种方式进行:
- 静水压缩(hydrostatic):使用
iso、aniso或tri关键字。此时三个方向的晶胞尺寸动态变化,使三个方向的平均轴向应力都收敛到目标值。 - 单轴压缩(uniaxial):使用
x、y或z关键字。此时只有所选方向的晶胞尺寸动态变化,使该方向的平均轴向应力收敛到目标值,另外两个方向保持固定(零横向应变)。
目标温度方程
本质上,Hugoniostat 模拟就是一个 NPT 模拟,只是把用户指定的目标温度替换为随时间变化的目标温度 :
其中各符号含义为:
- 、:瞬时温度与目标温度;
- 、:瞬时压力/轴向应力与参考压力/轴向应力(静水或单轴压缩时取相应含义);
- 、:瞬时体积与参考体积;
- 、:瞬时内能(势能加动能)与参考内能;
- :温度定义中使用的自由度数目;
- :玻尔兹曼常数;
- :瞬时温度对目标温度的负偏差。
当体系达到稳定平衡时, 应在零附近波动。、、 默认取模拟起始时刻的瞬时值,也可通过下述 fix_modify 的 e0、v0、p0 关键字覆盖。
源码中的实现对应
在 src/SHOCK/fix_nphug.cpp 中,目标温度与 Hugoniot 偏差由两个核心私有方法实现:
compute_temp_target():每步执行t_target = t_current + compute_hugoniot(),即上式 的数值实现,并据此更新目标动能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 文档 一致):
iso、aniso、tri、x、y、z六个压力关键字必须且只能使用其中一个;- 指定的初始与最终目标压力必须相同(
Pstart必须等于Pstop); - 关键字
xy、xz、yz不允许使用(Hugoniostat 不支持剪切应力目标); couple唯一允许的取值是xyz,其效果等同于关键字iso;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 方程中的内能 。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 会把 、、 以及所有恒温器/恒压器变量的状态写入二进制重启文件。源码中 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 方程中内能 的定义。
标量与向量输出
该 fix 计算一个全局标量,可通过各种输出命令访问,其值为上述累计能量变化,量纲为广延量(extensive)。
该 fix 还计算一个全局向量(各元素为强度量,intensive),向量的组织方式(与 src/SHOCK/fix_nphug.cpp 的 compute_vector() 一一对应):
| 向量索引 | 物理量 | 含义 |
|---|---|---|
1(f_fix[1]) |
温度对目标温度的偏差(温度单位),即 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():
其中当压缩量 过小(< 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)。
这个算例展示了几个关键实战要点:
fix_modify myhug e0 ... v0 ... p0 ...显式覆盖参考状态:e0 = -6334.0、v0 = 680.73519是论文中对应 1000 原子体系的总能量与总体积,p0 = 0.0;- 利用向量输出监视模拟质量:
f_myhug[1](,应围绕 0 波动)、f_myhug[2](Us)、f_myhug[3](up)直接出现在thermo_style中; econserve与epair一并输出,用于核对能量守恒;- 脚本对三次运行均使用
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 时才可用。构建方式:
- CMake:启用
PKG_SHOCK选项(cmake/CMakeLists.txt 中 SHOCK 位于标准包列表); - 传统 Make:使用 src/Make.sh 或
make yes-shock安装该包,具体参见 Build package 文档。
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 曲线收敛到指定目标应力。理解其关键字约束、 目标温度方程、三个专属输出量(、Us、up)以及 e0/v0/p0 参考状态的作用,是正确使用并解读结果的关键;examples/PACKAGES/shock/hugoniostat/in.hugoniostat 是直接可复现的权威模板,src/SHOCK/fix_nphug.cpp 则提供了每一步公式的数值实现细节,可供深入研究者进一步对照。