LAMMPS pair_style mie/cut 完全指南:Mie 势能模型、参数配置与源码级原理剖析
LAMMPS pair_style mie/cut 完全指南:Mie 势能模型、参数配置与源码级原理剖析
导读
pair_style mie/cut 是 LAMMPS 中实现广义 Mie 势能的非键对势样式,通过独立的排斥指数与吸引指数描述原子间相互作用,可精确还原 Lennard-Jones(LJ)势并推广到任意幂次组合,广泛用于流体相平衡与热物性研究。本文基于 LAMMPS 仓库中的官方命令文档 doc/src/pair_mie.rst,结合核心源码 src/EXTRA-PAIR/pair_mie_cut.cpp 与单元测试展开,帮助你掌握其数学形式、pair_style/pair_coeff 完整语法、混合规则、长程尾校正、rRESPA 支持以及 GPU/OpenMP/KOKKOS 加速变体的使用与底层实现原理。
概述:什么是 Mie 势能
Mie 势能是 1903 年由 Gustav Mie 提出的一般化幂函数型对势(见文档末尾引文 (Mie) G. Mie, Ann Phys, 316, 657 (1903)),其能量表达式为:
E = C·ε·[(σ/r)^γ_rep − (σ/r)^γ_att] r < r_c
其中:
ε(epsilon)为势阱深度,单位与当前units的能量单位一致;σ(sigma)为碰撞直径(距离单位),即势能过零点的距离;γ_rep(gammaR)与γ_att(gammaA)分别是排斥与吸引项的幂指数;r_c为截断距离(cutoff);C是由两个指数共同决定的归一化常数:
C = (γ_rep/(γ_rep−γ_att)) · (γ_rep/γ_att)^(γ_att/(γ_rep−γ_att))
常数 C 的作用是保证对于任意 (γ_rep, γ_att) 组合,势阱最小值都恰好位于 r = σ、深度恰好为 −ε,从而使 Mie 参数可以像 LJ 参数一样直观解读。当取经典 12/6 指数时,C = 4,上述公式退化为标准 Lennard-Jones 势:
E_LJ = 4·ε·[(σ/r)^12 − (σ/r)^6]
该退化关系在官方文档中有明确说明,也在 src/EXTRA-PAIR/pair_mie_cut.cpp 中通过相同的 Cmie 归一化公式实现,源码与文档公式完全一致。
背景参考:Mie 势的现代复兴主要得益于 Avendano 等人的工作(文档引文 (Avendano) C. Avendano, T. Lafitte, A. Galindo, C. S. Adjiman, G. Jackson, E. Muller, J Phys Chem B, 115, 11154 (2011)),其将 Mie 势用于 SAFT 型方程与流体的分子模拟研究。
语法与完整示例
pair_style mie/cut 的命令语法为:
pair_style mie/cut cutoff
cutoff:Mie 相互作用的全局截断距离(距离单位),为必填参数。settings()函数要求参数个数必须为 1,否则报错Illegal pair_style command(见 src/EXTRA-PAIR/pair_mie_cut.cpp)。
每个原子类型对必须通过 pair_coeff 命令定义系数,完整格式如下:
pair_style mie/cut 10.0
pair_coeff 1 1 0.72 3.40 23.00 6.66
pair_coeff 2 2 0.30 3.55 12.65 6.00
pair_coeff 1 2 0.46 3.32 16.90 6.31
pair_coeff 的五个必需参数依次为:
| 参数 | 含义 | 单位 |
|---|---|---|
epsilon |
势阱深度 ε | 能量单位 |
sigma |
碰撞直径 σ | 距离单位 |
gammaR |
排斥指数 γ_rep | 无单位(一般 > γ_att) |
gammaA |
吸引指数 γ_att | 无单位 |
cutoff(可选) |
该类型对的截断距离 | 距离单位 |
第 5 个参数 cutoff 是可选的:若省略,则该类型对使用 pair_style 命令中声明的全局截断。源码中 coeff() 通过参数个数(narg < 6 || narg > 7)严格校验:少于 6 个或多于 7 个参数都会报错 Incorrect args for pair coefficients(见 src/EXTRA-PAIR/pair_mie_cut.cpp)。
系数同样可以通过 read_data 命令读取的 data 文件、或 read_restart 命令读取的二进制重启文件中的 Pair Coeffs 段定义,命令文档详见 pair_coeff、read_data 与 read_restart。
参数深层含义与指数选择
ε 与 σ 的物理意义
在 Mie 势中,ε 直接对应势阱深度,σ 直接对应势能过零点(等价于 LJ 势中的参数)。二者无需换算即可直接沿用文献中报道的 Mie 参数,例如用 pair_style mie/cut 10.0 配合 pair_coeff 1 1 0.72 3.40 23.00 6.66 这类(ε, σ, γ_rep, γ_att)组合。
γ_rep 与 γ_att 的作用
排斥指数与吸引指数的相对大小决定势能曲线的形状:
- 更大的
γ_rep使排斥壁更陡峭,势能曲线更"硬"; γ_att通常取 6(对应色散力的渐进行为),但 Mie 势允许将其视为自由参数以更精确拟合实验数据或量子化学计算结果;- 必须保证
γ_rep > γ_att,否则C的归一化定义(含γ_rep − γ_att分母)无意义,这一约束由 src/EXTRA-PAIR/pair_mie_cut.cpp 中的Cmie计算直接体现。
当 γ_rep = 12, γ_att = 6 时即为标准 LJ 势,pair_style mie/cut 与 pair_style lj/cut 在数值上等价。
力与能量的源码实现:从公式到代码
从源码结构看,pair_style mie/cut 的核心计算位于类 PairMIECut::compute()(src/EXTRA-PAIR/pair_mie_cut.cpp)。为了在力循环中避免重复计算昂贵的幂函数,实现将势能公式预分解为四个系数:
mie1 = C·γ_rep·ε·σ^γ_rep
mie2 = C·γ_att·ε·σ^γ_att
mie3 = C·ε·σ^γ_rep
mie4 = C·ε·σ^γ_att
这些系数在 init_one() 中一次性算好(src/EXTRA-PAIR/pair_mie_cut.cpp),随后在力循环中只计算:
r2inv = 1/rsq
rgamA = r2inv^(γ_att/2) // 即 (1/r)^γ_att
rgamR = r2inv^(γ_rep/2) // 即 (1/r)^γ_rep
forcemie = mie1·rgamR − mie2·rgamA
fpair = factor_mie·forcemie·r2inv
其中 fpair 即径向力分量(正值对应排斥),原子受力为 delx·fpair 等分量(src/EXTRA-PAIR/pair_mie_cut.cpp)。注意两处工程优化:
- 力与能量分开计算:力循环只计算
forcemie,只有需要能量时才额外计算evdwl = mie3·rgamR − mie4·rgamA − offset,从而在纯力计算(如 NVE 不输出能量)时省去一次减法与查表; extract()接口:pair_style mie/cut实现了extract()方法,可向外暴露epsilon、sigma、gamR、gamA四个二维数组(src/EXTRA-PAIR/pair_mie_cut.cpp),供其他命令(如某些 fix/compute)读取参数,例如单元测试 mol-pair-mie_cut.yaml 正是通过extract段校验了这些参数数组。
single() 接口
除常规力循环外,该类还实现了 single() 方法(src/EXTRA-PAIR/pair_mie_cut.cpp),用于按给定 rsq 计算单次相互作用力与能量,这对 pair_write、pair_style hybrid 中需要按对调用的场景至关重要。从实现看,其公式与 compute() 完全一致,同样应用了 offset 平移。
截断处理、势能平移与长程尾校正
截断与 offset(shift 选项)
pair_style mie/cut 支持 pair_modify shift 选项,用于在截断处对势能进行平移,使 E(r_c) = 0,避免能量在截断处出现不连续。对应源码在 init_one() 中:
if (offset_flag && cut > 0)
offset = C·ε·[(σ/r_c)^γ_rep − (σ/r_c)^γ_att]
else
offset = 0.0
(见 src/EXTRA-PAIR/pair_mie_cut.cpp)。当 shift 未开启时 offset 恒为 0,能量表达式即为原始 Mie 势。
tail(长程尾校正)
该对势同样支持 pair_modify tail 选项,为能量与压力添加长程尾校正。源码中 init_one() 在 tail_flag 开启时,通过 MPI_Allreduce 统计全系统 i、j 类型原子总数,再按球面积分解析式计算 etail_ij 与 ptail_ij(src/EXTRA-PAIR/pair_mie_cut.cpp)。从推导可推断,该实现要求 γ_rep > 3 且 γ_att > 3,否则积分在无穷远处发散——因此使用 tail 时指数需满足该约束。pair_modify 的详细选项见 pair_modify。
rRESPA(多重时间步)支持
pair_style mie/cut 支持 run_style respa 的 inner、middle、outer 关键字,可将对力按距离分区到 rRESPA 层级的不同时间步上。源码中的证据链非常完整:
- 构造函数设置
respa_enable = 1(src/EXTRA-PAIR/pair_mie_cut.cpp); init_style()根据respa集成器层级自动请求REQ_RESPA_INOUT或REQ_RESPA_ALL邻列表,并读取cut_respa截断数组(src/EXTRA-PAIR/pair_mie_cut.cpp);- 专门实现
compute_inner()、compute_middle()、compute_outer()三个分层计算函数(src/EXTRA-PAIR/pair_mie_cut.cpp),各层之间用三次平滑函数rsw²·(3−2·rsw)过渡,保证力的连续性; init_one()末尾还会校验cut[i][j] ≥ cut_respa[3](内部截断),否则报错Pair cutoff < Respa interior cutoff。
run_style respa 的具体用法见 run_style。
混合规则(Mixing)
对于不同原子类型对(I ≠ J),若未显式给出 pair_coeff,ε、σ 与截断距离将按 LAMMPS 的混合规则自动生成。从源码 init_one() 可看到具体的混合行为(src/EXTRA-PAIR/pair_mie_cut.cpp):
epsilon使用mix_energy(与 σ 相关的能量混合规则);sigma、gammaR、gammaA、cutoff均使用mix_distance。
特别值得注意:文档明确说明——混合后的排斥指数与吸引指数遵循与距离相同的混合规则,默认混合方式为 geometric(几何平均:mix = sqrt(x_ii·x_jj))。也就是说,γ_rep 与 γ_att 并不会自动"按能量规则"混合,而是按距离规则处理,这与 σ 和截断的处理方式一致。混合方式可通过 pair_modify mix 命令改为 arithmetic、geometric 或 sixthpower;单元测试 mol-pair-mie_cut.yaml 中就在运行后通过 pair_modify mix arithmetic 切换混合规则以覆盖多种场景。详见 pair_modify。
特殊键缩放与邻列表
pair_style mie/cut 在力计算中通过 factor_mie = force->special_lj<a href="https://link.gitcode.com/i/a170b72a847d5025d097273bcccff07b" target="_blank">sbmask(j)] 应用特殊键(1-2、1-3、1-4 键对)缩放因子([src/EXTRA-PAIR/pair_mie_cut.cpp),即复用 LJ 的特殊键缩放权重。这意味着在分子体系中,该对势会像 LJ 势一样对成键邻居(及其二级、三级邻居)按 special_bonds 权重缩放相互作用——这在混合体系(如将 Mie 势用于分子的一部分)时需特别留意。邻列表请求由 init_style() 中的 neighbor->add_request() 完成,并支持 rRESPA 变体(src/EXTRA-PAIR/pair_mie_cut.cpp)。
重启文件支持
pair_style mie/cut 支持将全部对参数写入二进制重启文件:write_restart() 会逐类型对写入 setflag、epsilon、sigma、gamR、gamA、cut,write_restart_settings() 则写入 cut_global、offset_flag、mix_flag、tail_flag 等全局设置;读取时通过 MPI_Bcast 广播给所有进程(src/EXTRA-PAIR/pair_mie_cut.cpp)。因此,读取重启文件时无需在输入脚本中重复声明 pair_style 与 pair_coeff,详见 restart。
加速变体:GPU / KOKKOS / OpenMP
pair_style mie/cut 是 EXTRA-PAIR 包中少数同时提供全部主流加速变体的对势样式之一,官方文档声明的加速变体为:
pair_style mie/cut/gpu:GPU 加速;pair_style mie/cut/kk(以及mie/cut/kk/device、mie/cut/kk/host):KOKKOS 加速;pair_style mie/cut/omp:OpenMP 线程加速。
各变体对应源码文件:
- src/GPU/pair_mie_cut_gpu.cpp 与 src/GPU/pair_mie_cut_gpu.h(注册名
mie/cut/gpu); - src/KOKKOS/pair_mie_cut_kokkos.cpp 与 src/KOKKOS/pair_mie_cut_kokkos.h(注册名
mie/cut/kk、mie/cut/kk/device、mie/cut/kk/host); - src/OPENMP/pair_mie_cut_omp.cpp 与 src/OPENMP/pair_mie_cut_omp.h(注册名
mie/cut/omp)。
从源码结构看,三者均继承自基类 PairMIECut,因此共享 pair_coeff 语法、混合规则与系数预计算逻辑,只是把 compute() 循环改写为异构平台版本:
- GPU 变体:
PairMIECutGPU继承PairMIECut并重写compute()、init_style(),支持GPU_FORCE、GPU_NEIGH、GPU_HYB_NEIGH三种 GPU 加速模式(src/GPU/pair_mie_cut_gpu.h),由suffix gpu自动选择; - KOKKOS 变体:模板化类
PairMIECutKokkos<DeviceType>继承PairMIECut,通过ExecutionSpaceFromDevice自动适配 CPU/GPU 后端,并在compute()中利用datamask_read/modify做最小化数据同步(src/KOKKOS/pair_mie_cut_kokkos.cpp); - OpenMP 变体:
PairMIECutOMP通过ThrOMP线程池与loop_setup_thr做并行区间划分,#pragma omp parallel并行遍历邻居对(src/OPENMP/pair_mie_cut_omp.cpp)。
加速变体的通用启用方式(如 -sf gpu、-sf kk、-sf omp)见 accel_styles。需要注意的是:OMP 与 KOKKOS 变体在构造函数中设置了 respa_enable = 0,即这两个加速变体不支持 rRESPA;GPU 变体在非 GPU 邻列表模式下也可能有类似限制,选择 run_style respa 时应使用基类版本。
安装与启用条件
pair_style mie/cut 属于 EXTRA-PAIR 包,只有当 LAMMPS 以该包编译时才可用。EXTRA-PAIR 包在 doc/src/Packages_details.rst 中被描述为"不太常用的附加对势集合",安装方式与其他包一致(见 Build_package),典型配置:
cmake -D PKG_EXTRA-PAIR=on ../cmake
传统 make 方式则是在 src 目录执行 make yes-extra-pair 后重新编译。若未安装该包而使用 pair_style mie/cut,LAMMPS 会报错 "Unrecognized pair style"。相关示例可见 examples/PACKAGES/dispersion(README 明确指出其依赖 EXTRA-PAIR 与 ML-PACE 两个包),其中 in.d2、in.d3 演示了将短程机器学习势与色散校正结合的典型工程用法。
单元测试与正确性验证
LAMMPS 官方单元测试框架为每个对势样式提供了基于 YAML 的回归测试,pair_style mie/cut 的测试文件位于 unittest/force-styles/tests/mol-pair-mie_cut.yaml。该测试通过 unittest/force-styles 目录的测试驱动运行,其结构值得参考:
- 前提条件:需要
atom full原子样式与pair mie/cut样式; - 测试配置:
pair_style mie/cut 8.0,覆盖 5 种原子类型、6 组pair_coeff,指数跨度从9.9/4.5到12.1/6.1,能充分检验不同指数组合下的力与能量; - 验证方式:通过
extract段读取epsilon、sigma、gamR、gamA数组与初始/运行后的能量、压力张量、逐原子力做数值对照; - 混合规则覆盖:
post_commands中pair_modify mix arithmetic切换混合方式,说明测试同时验证了混合路径的正确性。
这为使用者提供了一份"可复现的验收清单":当修改实现或移植到新平台时,可用同一组参数快速回归验证。
默认值与注意事项小结
- 默认值:文档明确说明该样式无额外默认(
Default: none),所有系数必须显式给出或通过混合规则生成; - 必须显式设置:未通过
pair_coeff设置且类型不同(I ≠ J)的对,ε、σ、γ、截断全部依赖混合规则(默认几何平均); - 指数约束:使用
tail长程校正时需γ_rep, γ_att > 3;恒有γ_rep > γ_att; - 单位:所有参数单位随当前
units设置变化,距离类参数(σ、cutoff)与能量类参数(ε)务必使用一致的单位体系; - rRESPA 兼容性:基类支持
inner/middle/outer三层分区;OMP/KOKKOS 加速变体不支持 rRESPA。
快速上手示例
下面给出一个可直接运行的完整示例(混合两种原子类型,一个用显式系数、一个靠混合规则生成交叉项):
units real
atom_style full
boundary p p p
region box block 0 20 0 20 0 20
create_box 2 box
create_atoms 1 single 5 5 5
create_atoms 2 single 10 10 10
mass 1 1.0
mass 2 1.0
pair_style mie/cut 12.0
pair_coeff 1 1 0.20 3.40 23.00 6.66
pair_coeff 2 2 0.15 3.55 12.00 6.00
# 1-2 交叉项由混合规则自动生成(默认几何平均)
pair_modify shift yes
neighbor 2.0 bin
run 0
运行后可用 thermo 输出的势能(PotEng)与 compute pressure 交叉验证:将指数改为 12/6 后,结果应与同参数下 pair_style lj/cut 完全一致——这是检验 Mie 势归一化常数 C 是否正确的最直观手段。