LAMMPS 带库仑相互作用的截断 LJ 对势家族:lj/cut/coul/* 系列 pair_style 完全指南

原创2026-10-15 23:37:111,639 阅读
文章标签:科学计算高性能计算科研

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() 完全一致):

  1. 单截断:pair_style lj/cut/coul/cut 10.0 表示 LJ 与库仑共用 10.0 的距离截断;源码中 if (narg == 1) cut_coul_global = cut_lj_global;;
  2. 双截断: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 势:

E=4ϵ[(σr)12−(σr)6],r<rcE = 4\epsilon \left[ \left(\frac{\sigma}{r}\right)^{12} - \left(\frac{\sigma}{r}\right)^6 \right], \qquad r < r_c

其中 rcr_c 为该 pair 的截断距离。注意 LAMMPS 约定:σ\sigma 是势能过零点距离(zero-crossing),不是能量极小值位置(能量极小值位于 21/6σ2^{1/6}\sigma)。

4.2 lj/cut/coul/cut:纯截断库仑

在最简单的 lj/cut/coul/cut 中,库仑项为:

E=Cqiqjϵ r,r<rcE = \frac{C q_i q_j}{\epsilon \, r}, \qquad r < r_c

其中 CC 是能量转换常数(源码中的 qqrd2e,由 units 决定,real 单位下为 332.06371),qiq_i、qjq_j 为两原子电荷,ϵ\epsilon 为介电常数,由 dielectric 命令 设置(默认 1.0)。该风格适合带电体系规模较小、或短程屏蔽明显、截断误差可接受的场景,是最廉价的选择。

4.3 lj/cut/coul/debye:德拜屏蔽

lj/cut/coul/debye 在库仑项上附加一个 exp() 屏蔽因子:

E=Cqiqjϵ rexp⁡(−κr),r<rcE = \frac{C q_i q_j}{\epsilon \, r} \exp(-\kappa r), \qquad r < r_c

κ\kappa 是德拜长度(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):

E=qiqj[erfc(αr)r−erfc(αrc)rc+(erfc(αrc)rc2+2απexp⁡(−α2rc2)rc)(r−rc)],r<rcE = q_i q_j \left[ \frac{\mathrm{erfc}(\alpha r)}{r} - \frac{\mathrm{erfc}(\alpha r_c)}{r_c} + \left( \frac{\mathrm{erfc}(\alpha r_c)}{r_c^2} + \frac{2\alpha}{\sqrt{\pi}} \frac{\exp(-\alpha^2 r_c^2)}{r_c} \right)(r - r_c) \right], \qquad r < r_c

其中 α\alpha 为阻尼参数,erfc() 为余误差函数。该势本质上是短程、球面截断、电荷中和、移位的成对 1/r1/r 求和,基于 Wolf 求和思想,适用于电荷屏蔽使得静电相互作用有效短程化的凝聚相体系。为保证静电和绝对收敛,截断球内通过放置镜像电荷实现电荷中和(体现在势函数的移位项上);α\alpha 取一个小的非零值通常能改善收敛性。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)):

Ei=12∑j≠iqiqj erfc(αrij)rij+12∑j≠iqiqj erf(αrij)rij,r<rcE_i = \frac{1}{2}\sum_{j \neq i} \frac{q_i q_j \,\mathrm{erfc}(\alpha r_{ij})}{r_{ij}} + \frac{1}{2}\sum_{j \neq i} \frac{q_i q_j \,\mathrm{erf}(\alpha r_{ij})}{r_{ij}}, \qquad r < r_c

通过对第一、第二项分别加减一个自项(i = j),并取足够小的 α\alpha,第二项将收缩,势能退化为快速收敛的实空间求和。只要截断足够长、α\alpha 足够小,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 读取,或通过混合规则生成):

系数 含义 单位
ε 势阱深度 能量单位
σ 势能过零点距离(非能量极小点 21/6σ2^{1/6}\sigma) 距离单位
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 的文件头注释中予以引用。

登录后查看全文
lammps