LAMMPS 带库仑相互作用的截断 LJ 对势家族:lj/cut/coul/* 系列 pair_style 完全指南
LAMMPS 带库仑相互作用的截断 LJ 对势家族:lj/cut/coul/* 系列 pair_style 完全指南
本篇技术指南系统讲解 LAMMPS 中最常用的“Lennard-Jones 12/6 + 库仑相互作用”对势家族——lj/cut/coul/cut、lj/cut/coul/debye、lj/cut/coul/dsf、lj/cut/coul/esp、lj/cut/coul/long、lj/cut/coul/msm 与 lj/cut/coul/wolf。你将掌握每个变体的适用场景、语法参数、势函数数学形式、pair_coeff 系数规则,以及它们与 KSpace 长程求解器、pair_modify、rRESPA 等机制的配合方式,并借助仓库源码(src/pair_lj_cut_coul_cut.cpp、src/KSPACE/pair_lj_cut_coul_long.cpp 等)理解其底层实现原理。
一、家族总览:七种库仑处理策略
lj/cut/coul 系列的全部变体都共享同一个 12/6 Lennard-Jones 势能项,区别只在于库仑部分的处理方式:是直接截断、加指数屏蔽、用阻尼移位力、Wolf 求和,还是交给 kspace_style 在倒空间求解。官方文档 doc/src/pair_lj_cut_coul.rst 将七个风格及其加速变体汇总如下:
| pair_style | 库仑处理方式 | 附加参数 | 所属包 | 加速变体 |
|---|---|---|---|---|
lj/cut/coul/cut |
直接截断(plain cutoff) | 无 | 核心 | gpu、kk、omp |
lj/cut/coul/debye |
exp(-κr) 屏蔽,模拟极性溶剂 | kappa(德拜长度倒数) | EXTRA-PAIR | gpu、kk、omp |
lj/cut/coul/dsf |
阻尼移位力(Fennell 模型) | alpha(阻尼参数) | EXTRA-PAIR | gpu、kk、omp |
lj/cut/coul/esp |
与 kspace 配合(ESP 变体) | 无 | KSPACE | omp |
lj/cut/coul/long |
与 kspace 配合(ewald/pppm) | 无 | KSPACE | gpu、kk、intel、opt、omp |
lj/cut/coul/msm |
与 kspace 配合(MSM) | 无 | KSPACE | gpu、omp |
lj/cut/coul/wolf |
Wolf 求和(erfc 实空间求和) | alpha(阻尼参数) | EXTRA-PAIR | kk、omp |
esp变体在文档中以.. versionadded:: 4Jul2026标注,是较新的成员;- 加速变体需要 LAMMPS 以对应加速包(GPU、KOKKOS、INTEL、OPT、OPENMP)编译后才可用;
debye、dsf、wolf属于 EXTRA-PAIR 包,esp、long、msm属于 KSPACE 包,均非核心自带,需按 doc/src/Build_package.rst 中的说明构建对应包。
二、语法与参数详解
所有风格统一采用 pair_style style args 的形式,参数随风格不同而不同:
lj/cut/coul/cut args = cutoff (cutoff2)
cutoff = LJ 全局截断(若只给 1 个参数,同时作为库仑截断)
cutoff2 = 库仑全局截断(可选)
lj/cut/coul/debye args = kappa cutoff (cutoff2)
kappa = 德拜长度倒数,量纲为 1/距离
cutoff = LJ 全局截断(若只给 1 个参数,同时作为库仑截断)
cutoff2 = 库仑全局截断(可选)
lj/cut/coul/dsf args = alpha cutoff (cutoff2)
alpha = 阻尼参数,量纲为 1/距离
cutoff = LJ 全局截断(注意:dsf 的 alpha 之后**必须**显式给出 LJ cutoff)
cutoff2 = 库仑截断(dsf 中库仑截断为必填项,不可省略)
lj/cut/coul/esp args = cutoff (cutoff2)
lj/cut/coul/long args = cutoff (cutoff2)
lj/cut/coul/msm args = cutoff (cutoff2)
cutoff = LJ 全局截断(若只给 1 个参数,同时作为库仑截断)
cutoff2 = 库仑全局截断(可选)
lj/cut/coul/wolf args = alpha cutoff (cutoff2)
alpha = 阻尼参数,量纲为 1/距离
cutoff = LJ 全局截断(wolf 的 alpha 之后**必须**显式给出 LJ cutoff)
cutoff2 = 库仑截断(可选,缺省取 LJ cutoff)
两个关键语义(与源码 src/pair_lj_cut_coul_cut.cpp 的 settings() 完全一致):
- 单截断:
pair_style lj/cut/coul/cut 10.0表示 LJ 与库仑共用 10.0 的距离截断;源码中if (narg == 1) cut_coul_global = cut_lj_global;; - 双截断:
pair_style lj/cut/coul/cut 10.0 8.0表示 LJ 截断 10.0、库仑截断 8.0,两个项分别在各自的截断内计算。
三、官方示例与可运行的最小输入脚本
文档给出的各风格示例完整罗列如下:
pair_style lj/cut/coul/cut 10.0
pair_style lj/cut/coul/cut 10.0 8.0
pair_coeff * * 100.0 3.0
pair_coeff 1 1 100.0 3.5 9.0
pair_coeff 1 1 100.0 3.5 9.0 9.0
pair_style lj/cut/coul/debye 1.5 3.0
pair_style lj/cut/coul/debye 1.5 2.5 5.0
pair_coeff * * 1.0 1.0
pair_coeff 1 1 1.0 1.5 2.5
pair_coeff 1 1 1.0 1.5 2.5 5.0
pair_style lj/cut/coul/dsf 0.05 2.5 10.0
pair_coeff * * 1.0 1.0
pair_coeff 1 1 1.0 1.0 2.5
pair_style lj/cut/coul/esp 10.0
pair_style lj/cut/coul/esp 10.0 8.0
pair_coeff * * 100.0 3.0
pair_coeff 1 1 100.0 3.5 9.0
pair_style lj/cut/coul/long 10.0
pair_style lj/cut/coul/long 10.0 8.0
pair_coeff * * 100.0 3.0
pair_coeff 1 1 100.0 3.5 9.0
pair_style lj/cut/coul/msm 10.0
pair_style lj/cut/coul/msm 10.0 8.0
pair_coeff * * 100.0 3.0
pair_coeff 1 1 100.0 3.5 9.0
pair_style lj/cut/coul/wolf 0.2 5. 10.0
pair_coeff * * 1.0 1.0
pair_coeff 1 1 1.0 1.0 2.5
将这些片段组合成一个带电荷原子的真实输入脚本(以 lj/cut/coul/long 为例),注意必须同时满足三个前置条件:atom_style full(或至少包含电荷属性 q)、显式设置 kspace_style、正确构建 KSPACE 包:
units real
atom_style full
boundary p p p
read_data data.charged
pair_style lj/cut/coul/long 10.0 8.0
pair_coeff 1 1 0.1553 3.166
kspace_style pppm 1.0e-4
velocity all create 300.0 4928459
fix 1 all nvt temp 300.0 300.0 100.0
timestep 1.0
run 1000
仓库中 examples/HEAT/in.spce.hex 就是 lj/cut/coul/long + kspace_style ewald 的真实案例(见该文件第 62–68 行):
pair_style lj/cut/coul/long ${cutLJ} ${cutC}
pair_coeff 2 2 ${epsOO} ${sigOO}
pair_coeff 1 2 0 0
pair_coeff 1 1 0 0
...
kspace_style ewald 1.e-5
四、势函数数学形式与物理含义
4.1 共同的 12/6 Lennard-Jones 项
所有 lj/cut/coul 风格都计算标准的 12/6 Lennard-Jones 势:
其中 为该 pair 的截断距离。注意 LAMMPS 约定: 是势能过零点距离(zero-crossing),不是能量极小值位置(能量极小值位于 )。
4.2 lj/cut/coul/cut:纯截断库仑
在最简单的 lj/cut/coul/cut 中,库仑项为:
其中 是能量转换常数(源码中的 qqrd2e,由 units 决定,real 单位下为 332.06371),、 为两原子电荷, 为介电常数,由 dielectric 命令 设置(默认 1.0)。该风格适合带电体系规模较小、或短程屏蔽明显、截断误差可接受的场景,是最廉价的选择。
4.3 lj/cut/coul/debye:德拜屏蔽
lj/cut/coul/debye 在库仑项上附加一个 exp() 屏蔽因子:
是德拜长度(Debye length)的倒数,用于模拟极性溶剂对静电的屏蔽效应,是“溶剂隐性处理”的另一种手段。从源码 src/EXTRA-PAIR/pair_lj_cut_coul_debye.cpp 可见其力的计算直接体现了这一形式:
r = sqrt(rsq);
rinv = 1.0/r;
screening = exp(-kappa*r);
forcecoul = qqrd2e * qtmp*q[j] * screening * (kappa + rinv);
4.4 lj/cut/coul/dsf:阻尼移位力(Fennell 模型)
lj/cut/coul/dsf 采用 Fennell & Gezelter 提出的阻尼移位力(damped shifted force)模型(J Chem Phys, 124, 234104 (2006),源码注释见 src/EXTRA-PAIR/pair_lj_cut_coul_dsf.cpp):
其中 为阻尼参数,erfc() 为余误差函数。该势本质上是短程、球面截断、电荷中和、移位的成对 求和,基于 Wolf 求和思想,适用于电荷屏蔽使得静电相互作用有效短程化的凝聚相体系。为保证静电和绝对收敛,截断球内通过放置镜像电荷实现电荷中和(体现在势函数的移位项上); 取一个小的非零值通常能改善收敛性。DSF 与 Wolf 均在代码中为每个原子计算一个自能量修正项(见 src/EXTRA-PAIR/pair_lj_cut_coul_dsf.cpp):
double e_self = -(e_shift/2.0 + alpha/MY_PIS) * qtmp*qtmp*qqrd2e;
ev_tally(i,i,nlocal,0,0.0,e_self,0.0,0.0,0.0,0.0);
4.5 lj/cut/coul/esp、/long、/msm:与 kspace_style 配合的长程库仑
lj/cut/coul/esp、lj/cut/coul/long、lj/cut/coul/msm 计算与 lj/cut/coul/cut 相同的库仑相互作用,但额外施加阻尼因子,使其能与 kspace_style 命令 的 ewald、pppm、msm 选项配合使用:
- 在指定的库仑截断以内:实空间直接计算成对相互作用;
- 在截断以外:由倒空间(reciprocal space)求解器计算。
三者差别在于匹配的倒空间求解器:long 匹配 ewald/pppm(源码 src/KSPACE/pair_lj_cut_coul_long.cpp 中 ewaldflag = pppmflag = 1),msm 匹配 msm,esp 则是面向 ESP 方法的变体(src/KSPACE/pair_lj_cut_coul_esp.cpp 中 ewaldflag = pppmflag = 1; espflag = 1;)。
4.6 lj/cut/coul/wolf:Wolf 求和
lj/cut/coul/wolf 通过 Wolf 求和实现库仑相互作用(D. Wolf 等,J Chem Phys, 110, 8254 (1999)):
通过对第一、第二项分别加减一个自项(i = j),并取足够小的 ,第二项将收缩,势能退化为快速收敛的实空间求和。只要截断足够长、 足够小,Wolf 求和得到的能量与力将趋近于 Ewald 和的结果——因此它被定位为“用短程势获得有效长程相互作用”的手段。源码 src/EXTRA-PAIR/pair_lj_cut_coul_wolf.cpp 中先计算移位量与移位力:
e_shift = erfc(alf*cut_coul)/cut_coul;
f_shift = -(e_shift + 2.0*alf/MY_PIS * exp(-alf*alf*cut_coul*cut_coul)) / cut_coul;
再对每个原子计入自能量修正(第 117–119 行):
qisq = qtmp*qtmp;
e_self = -(e_shift/2.0 + alf/MY_PIS) * qisq*qqrd2e;
if (eflag) ev_tally(i,i,nlocal,0,0.0,e_self,0.0,0.0,0.0,0.0);
五、pair_coeff 系数设置与截断优先级
对所有 lj/cut/coul 风格,每对原子类型都需要通过 pair_coeff 命令 定义如下系数(也可写在 data 文件或 restart 文件中,由 read_data / read_restart 读取,或通过混合规则生成):
| 系数 | 含义 | 单位 |
|---|---|---|
| ε | 势阱深度 | 能量单位 |
| σ | 势能过零点距离(非能量极小点 ) | 距离单位 |
| cutoff1(可选) | 该类型对的 LJ 截断 | 距离单位 |
| cutoff2(可选) | 该类型对的库仑截断 | 距离单位 |
后两个系数可选,解析逻辑见 src/pair_lj_cut_coul_cut.cpp 的 coeff():
- 若未指定,使用 pair_style 命令中的全局 LJ 与库仑截断;
- 若只指定一个截断,则该截断同时用于 LJ 与库仑;
- 若指定两个,分别作为 LJ 与库仑截断。
pair_coeff 1 1 100.0 3.5 # 只有 ε、σ,截断全部取全局值
pair_coeff 1 1 100.0 3.5 9.0 # 一个截断:LJ 与库仑均为 9.0
pair_coeff 1 1 100.0 3.5 9.0 9.0 # 两个截断:LJ 与库仑各自为 9.0
特殊限制:lj/cut/coul/esp、lj/cut/coul/long、lj/cut/coul/msm 只允许为单个类型对指定 LJ 截断,不能指定个别类型对的库仑截断——所有类型对共用 pair_style 中设定的全局库仑截断(因为倒空间求解器要求统一截断)。
六、源码级实现细节
6.1 参数解析与检查
- src/pair_lj_cut_coul_cut.cpp 的
settings()接收 1–2 个参数;参数数量非法时抛出Illegal pair_style command; coeff()接收 4–6 个参数(I J ε σ [cutoff1] [cutoff2]),不足或超限时报Incorrect args for pair coefficients;init_style()(src/pair_lj_cut_coul_cut.cpp)检查原子必须带电荷属性:
if (!atom->q_flag) error->all(FLERR, "Pair style lj/cut/coul/cut requires atom attribute q");
因此使用 atom_style atomic 等无电荷风格时该家族会直接报错,需改用 full、charge 等带 q 的风格。
6.2 计算内核中的“双截断”判断
compute() 内核(src/pair_lj_cut_coul_cut.cpp)对每个邻居对分别用 cut_coulsq[itype][jtype] 与 cut_ljsq[itype][jtype] 判断是否计算库仑/ LJ 力,实现了文档所述的“LJ 与库仑可各自截断”:
if (rsq < cut_coulsq[itype][jtype])
forcecoul = qqrd2e * qtmp * q[j] * sqrt(r2inv); // C·qᵢqⱼ/r
...
if (rsq < cut_ljsq[itype][jtype]) {
r6inv = r2inv * r2inv * r2inv;
forcelj = r6inv * (lj1[itype][jtype] * r6inv - lj2[itype][jtype]);
}
lj1–lj4 四个预计算系数在 init_one()(src/pair_lj_cut_coul_cut.cpp)中由 ε、σ 一次性算出,避免在每个时间步反复做幂运算:
lj1 = 48.0 * ε * σ¹²; lj2 = 24.0 * ε * σ⁶;
lj3 = 4.0 * ε * σ¹²; lj4 = 4.0 * ε * σ⁶;
6.3 与 KSpace 的衔接
lj/cut/coul/long 的 init_style()(src/KSPACE/pair_lj_cut_coul_long.cpp)强制校验 kspace 求解器必须存在,并同步阻尼参数:
if (force->kspace == nullptr)
error->all(FLERR,"Pair style requires a KSpace style");
g_ewald = force->kspace->g_ewald;
也就是说,只写 pair_style lj/cut/coul/long 而不写 kspace_style 是无法运行的——这正是第三节输入脚本中必须包含 kspace_style 的原因。
6.4 restart 支持与数据文件写出
所有 lj/cut 风格都会把信息写入二进制 restart 文件(见 restart 命令文档),因此读取 restart 文件的输入脚本无需再写 pair_style 与 pair_coeff 命令。对应实现为 src/pair_lj_cut_coul_cut.cpp 的 write_restart() / read_restart() / write_restart_settings(),其中保存了 ε、σ、cut_lj、cut_coul 以及 offset_flag、mix_flag、tail_flag 等设置;write_data()(第 417–431 行)则负责把系数写入 data 文件。
七、混合规则、移位/尾部修正与 rRESPA 支持
本节信息适用于全部 lj/cut/coul 风格,详见 pair_modify 命令文档 与 run_style 命令文档:
- 混合(mixing):对类型对 I,J(I ≠ J),ε、σ 与截断距离都可以混合,默认混合方式为
geometric(几何平均),可通过pair_modify mix改为arithmetic等; - shift 选项:所有
lj/cut风格都支持pair_modify shift,用于对 LJ 能量部分做移位(offset 修正,源码中的offset<a href="https://link.gitcode.com/i/00f96ad5cfb65eab292322be61d02e3e" target="_blank">itype][jtype]在init_one()中按4ε[(σ/r_c)¹² - (σ/r_c)⁶]计算,见 [src/pair_lj_cut_coul_cut.cpp); - table 选项:
lj/cut/coul/esp与lj/cut/coul/long支持pair_modify table,可将长程库仑相互作用的短程部分制成查找表加速(源码中对应ftable与ncoultablebits逻辑,见 src/KSPACE/pair_lj_cut_coul_long.cpp 附近); - tail 选项:所有
lj/cut风格都支持pair_modify tail,对 LJ 部分的能量与压力添加长程尾部修正(tail correction)。tail_flag开启时,init_one()会通过MPI_Allreduce统计各类型原子数并计算etail_ij、ptail_ij,见 src/pair_lj_cut_coul_cut.cpp; - rRESPA 支持:
lj/cut/coul/esp与lj/cut/coul/long支持run_style respa的inner、middle、outer关键字,即成对作用力可按距离在不同 rRESPA 层级上分区计算(源码中二者均设置respa_enable = 1,见 src/KSPACE/pair_lj_cut_coul_long.cpp);其余风格只支持run_style respa的pair关键字。
八、构建要求与包依赖
根据文档 doc/src/pair_lj_cut_coul.rst 的 Restrictions 一节:
lj/cut/coul/esp、lj/cut/coul/long、lj/cut/coul/msm属于 KSPACE 包;lj/cut/coul/debye、lj/cut/coul/dsf、lj/cut/coul/wolf属于 EXTRA-PAIR 包;- 只有在 LAMMPS 以相应包构建时这些风格才可用。例如 cmake 构建时开启包:
cmake -D PKG_KSPACE=on -D PKG_EXTRA-PAIR=on -D PKG_OPENMP=on ../cmake
cmake --build .
传统 make 方式则使用 make yes-kspace yes-extra-pair 后再编译。加速变体(gpu/kk/intel/opt/omp)还需对应开启 GPU、KOKKOS、INTEL、OPT、OPENMP 包。
九、测试用例与仓库实例佐证
本家族在仓库中拥有完整的一对一单元测试,位于 unittest/force-styles/tests/:
mol-pair-lj_cut_coul_cut.yaml:pair_style lj/cut/coul/cut 8.0,并给出pair_coeff多类型示例与init_vdwl、init_coul、init_forces、run_stress等参考数值,用于回归比对;mol-pair-lj_cut_coul_dsf.yaml:pair_style lj/cut/coul/dsf 0.25 8.0;- 另有
mol-pair-lj_cut_coul_debye.yaml、mol-pair-lj_cut_coul_esp.yaml、mol-pair-lj_cut_coul_long.yaml、mol-pair-lj_cut_coul_msm.yaml、mol-pair-lj_cut_coul_wolf.yaml,以及mol-pair-lj_cut_coul_long_soft.yaml、mol-pair-lj_cut_coul_cut_soft.yaml(FEP 软核变体)和mol-pair-hybrid_dsf_wolf.yaml(hybrid 混用)等。
这些 YAML 测试由 pair_style 字段给出所用风格、pair_coeff 字段给出系数、extract 字段校验 epsilon/sigma/cut_coul 等内部量,是验证参数解析与数值正确性的直接证据。
十、选型建议与常见问题
选型速查
- 体系较小、静电截断误差可接受 →
lj/cut/coul/cut(最省计算); - 想用短程势近似长程库仑 →
lj/cut/coul/wolf或lj/cut/coul/dsf(需调小 α,截断取足够长); - 显式模拟溶剂屏蔽 →
lj/cut/coul/debye(选合适的 κ); - 需要高精度长程静电(Ewald/PPPM)→
lj/cut/coul/long+kspace_style pppm,这是带电荷凝聚相体系最主流的选择; - 需要 MSM 长程求解 →
lj/cut/coul/msm+kspace_style msm; - 自由能微扰计算 → 改用 FEP 包提供的软核版本
lj/cut/coul/soft与lj/cut/coul/long/soft,详见 pair_fep_soft 文档(对应源码 src/FEP/pair_lj_cut_coul_long_soft.cpp 与 src/FEP/pair_lj_cut_coul_cut_soft.cpp)。
常见报错与对策
Pair style lj/cut/coul/cut requires atom attribute q:atom_style 未含电荷,改用atom_style full;Pair style requires a KSpace style(仅 long/esp/msm):忘记设置kspace_style,或所用 kspace 与风格不匹配(如msm风格配pppm);- 提示风格未定义:对应包(KSPACE/EXTRA-PAIR)未构建;
- 参数数量不符:
dsf/wolf必须依次给出 alpha 与 LJ cutoff,debye必须给出 kappa,缺一不可。
参考依据
- D. Wolf, P. Keblinski, S. R. Phillpot, J. Eggebrecht, J Chem Phys, 110, 8254 (1999)(Wolf 求和);
- C. J. Fennell, J. D. Gezelter, J Chem Phys, 124, 234104 (2006)(DSF 阻尼移位力)。
以上两篇文献出处也标注在文档 doc/src/pair_lj_cut_coul.rst 末尾的参考条目中,并在 src/EXTRA-PAIR/pair_lj_cut_coul_dsf.cpp 的文件头注释中予以引用。