LAMMPS 中 SPICA 粗粒化力场:pair_style lj/spica 系列势函数的完整使用指南

原创2026-10-16 12:56:051,941 阅读
文章标签:科学计算高性能计算科研

LAMMPS 中 SPICA 粗粒化力场:pair_style lj/spica 系列势函数的完整使用指南

导读

本文聚焦 LAMMPS 的 CG-SPICA 包中 lj/spica、lj/spica/coul/long、lj/spica/coul/msm 三个 pair 势函数,讲解它们如何实现 SPICA(旧称 SDK)与 pSPICA 粗粒化力场所要求的 9/6、12/4、12/5、12/6 型 Lennard-Jones 相互作用,以及如何与长程静电求解器(ewald / pppm / pppm/cg / msm)配合使用。读完本文,你将掌握这三类势函数的语法、pair_coeff 参数语义、混合规则与限制、加速器变体,并能基于仓库自带的 SDS 表面活性剂单分子层与 PEG 双亲分子示例,快速搭建可运行的粗粒化模拟脚本。

一、势函数定位:SPICA / pSPICA 粗粒化力场

lj/spica 系列势函数服务于 SPICA(formerly SDK)与 pSPICA 粗粒化分子动力学参数化方案,适用于生物体系与软材料体系(如表面活性剂、脂质、聚合物、水界面等)的模拟。其理论基础来自以下文献:

  • SDK:Shinoda, DeVane, Klein, Mol Sim, 33, 27-36 (2007)
  • DeVane 拓展:Shinoda, DeVane, Klein, Soft Matter, 4, 2453-2462 (2008)
  • SPICA:Seo, Shinoda, J Chem Theory Comput, 15, 762-774 (2019)
  • pSPICA:Miyazaki, Okazaki, Shinoda, J Chem Theory Comput, 16, 782-793 (2020)

在仓库中,该包的实现位于 src/CG-SPICA,包内 README 明确说明它实现了 4 条命令:pair_style lj/spica、pair_style lj/spica/coul/long、pair_style lj/spica/coul/msm 与 angle_style spica。当前为第三代实现(版本 2.0),即把原来的 lj/sdk、lj/sdk/coul/long、lj/sdk/coul/msm、angle_style sdk 重命名而来,并新增了 12/5 型指数组合;旧风格名仍作为向后兼容别名保留(见 src/CG-SPICA/README)。

二、命令语法与加速器变体

2.1 pair_style lj/spica

pair_style lj/spica cutoff
  • cutoff:LJ 相互作用的全局截断距离(距离单位)。

加速器变体:lj/spica/gpu、lj/spica/kk、lj/spica/omp。

2.2 pair_style lj/spica/coul/long

pair_style lj/spica/coul/long cutoff (cutoff2)
  • cutoff:LJ(且当只给 1 个参数时也作为库仑)的全局截断(距离单位)。
  • cutoff2(可选):库仑相互作用的全局截断(距离单位)。

加速器变体:lj/spica/coul/long/gpu、lj/spica/coul/long/omp、lj/spica/coul/long/kk。

2.3 pair_style lj/spica/coul/msm

pair_style lj/spica/coul/msm cutoff (cutoff2)

参数语义与 lj/spica/coul/long 相同,区别在于长程静电求解器使用 MSM(Multi-Level Summation Method)而非 Ewald/PPPM。加速器变体:lj/spica/coul/msm/omp。

2.4 官方示例

pair_style lj/spica 2.5
pair_coeff 1 1 lj12_6 1 1.1 2.8

pair_style lj/spica/coul/long 10.0
pair_style lj/spica/coul/long 10.0 12.0
pair_coeff 1 1 lj9_6 100.0 3.5 12.0

pair_style lj/spica/coul/msm 10.0
pair_style lj/spica/coul/msm 10.0 12.0
pair_coeff 1 1 lj9_6 100.0 3.5 12.0

从源码角度看,lj/spica 的 settings() 要求恰好 1 个参数(pair_lj_spica.cpp),而 lj/spica/coul/long 的 settings() 允许 1 或 2 个参数:只给 1 个时库仑截断自动等于 LJ 截断(cut_coul = cut_lj_global,见 pair_lj_spica_coul_long.cpp)。lj/spica/coul/msm 则直接继承自 PairLJSPICACoulLong,仅将标志改为 msmflag = 1(见 pair_lj_spica_coul_msm.cpp)。

三、势函数形式:四种指数组合的数学表达

lj/spica 系列根据 cg_type 的不同,计算四种带不同预因子与指数的 Lennard-Jones 型势能,均以 σ 为零势能穿越距离、以 r_c 为截断:

9/6 型(lj9_6)

E = (27/4)·ε·[(σ/r)⁹ − (σ/r)⁶],r < r_c

12/4 型(lj12_4)

E = (3√3/2)·ε·[(σ/r)¹² − (σ/r)⁴],r < r_c

12/5 型(lj12_5)

E = (12/7)·(12/5)^(5/7)·ε·[(σ/r)¹² − (σ/r)⁵],r < r_c

12/6 型(lj12_6)

E = 4ε·[(σ/r)¹² − (σ/r)⁶],r < r_c

这些数值预因子与指数在源码 lj_spica_common.h 中有一一对应的常量表:

类型标识 预因子 lj_prefact 指数 1 (lj_pow1) 指数 2 (lj_pow2)
lj9_6 6.75 9 6
lj12_4 2.59807621135332 12 4
lj12_6 4.0 12 6
lj12_5 3.20377984125109 12 5

pair_lj_spica.cpp 中 init_one() 据此预计算四个系数 lj1/lj2/lj3/lj4(分别用于力与能量的两个幂次项),运行时按 lj_type[i][j] 分支计算力与能量。能量最小值被标定在 -ε 处,而 σ 定义为势能函数的零穿越距离而非能量极小点——这正是 SPICA 参数化中区分 "well depth 位置" 与 "zero crossing" 的关键约定。

四、pair_coeff 参数详解

对每一对原子类型,必须通过 pair_coeff 命令定义以下系数:

pair_coeff I J cg_type epsilon sigma (cutoff1)
  • cg_type:只能是 lj9_6、lj12_4、lj12_5、lj12_6 之一;
  • epsilon:能量单位;
  • sigma:距离单位(势能零穿越距离);
  • cutoff1(可选):该类型对的 LJ 截断,距离单位。

后两个系数均可选:

  • 若不指定,使用 pair_style 命令中设置的全局 LJ(和库仑)截断;
  • 若只指定一个截断,则它对 LJ 与库仑同时生效(仅对 lj/spica/coul/long、lj/spica/coul/msm 而言不适用于库仑,见下文);
  • 若同时指定两个系数,则分别用作该类型对的 LJ 与库仑截断。

注意:对 lj/spica/coul/long 与 lj/spica/coul/msm,pair_coeff 中只能指定 LJ 截断,不能为单个 I,J 类型对指定库仑截断——所有类型对共用 pair_style 中设定的全局库仑截断。源码中 coeff() 的签名即为 narg < 5 || narg > 6 时报错,第 6 个参数仅被解释为 cut_lj_one(见 pair_lj_spica_coul_long.cpp)。

系数也可以通过 read_data / read_restart 读入,或按下文“混合规则”一节所述显式设置——需要强调的是,lj/spica 系列不支持混合规则。

4.1 与 kspace_style 的配合

lj/spica/coul/long 在实空间库仑项上施加了阻尼因子(erfc 型衰减),以便与 kspace_style 的 ewald、pppm 或 pppm/cg 选项联用。该风格指定的库仑截断意味着:截断距离内的对相互作用在实空间直接计算,超出部分由倒空间(k 空间)求解器计算。源码层面,init_style() 强制要求原子属性 q、要求必须存在 KSpace 求解器(否则报 Pair style requires a KSpace style),并从 force->kspace->g_ewald 取得 Ewald 参数(见 pair_lj_spica_coul_long.cpp)。

lj/spica/coul/msm 则要求使用 MSM 系列 kspace(如 kspace_style msm 或 msm/cg),且需要 kspace_modify pressure/scalar no(见 pair_lj_spica_coul_msm.cpp)。

4.2 pppm/cg:面向"少数带电粒子"系统的优化

SPICA 粗粒化体系的一个典型特征是大多数珠子不带电、带电类型很少。LAMMPS 为此专门提供 kspace_style pppm/cg,其行为与标准 pppm 完全一致,但对"绝大多数粒子不带电"的系统做了优化;可选的 smallq 参数(默认 1.0e-5)用于界定粒子是否被视为带电(见 kspace_style.rst)。CG-SPICA 包 README 也特别建议:使用 pppm/cg 优于普通 pppm,并且对于许多长程静电系统,用 pair_style hybrid/overlay 把 lj/spica 与 coul/long 组合,往往比直接用合并的 lj/spica/coul/long 更快——因为带电类型数量通常很少。

五、混合、平移、查表、tail 修正与 rRESPA

5.1 混合规则(Mixing):不支持

对于 I ≠ J 的类型对,由于不同对可能使用不同的指数组合,lj/spica 系列的 epsilon、sigma 与截断均不能通过混合规则自动生成。因此所有类型对的全部参数都必须通过 pair_coeff 显式指定;同时,由于 data 文件格式的限制,在 data 文件中定义这些参数也不被支持。源码在 init_one() 中对此直接报错:No mixing support for lj/spica. Coefficients for all pairs need to be set explicitly.(见 pair_lj_spica.cpp)。

注意 write_data 同样受限:源码要求必须使用 write_data ... pair ij 选项才能写出系数(否则报 Pair style lj/spica requires using write_data with the 'pair ij' option),write_data_all() 则按 i j cg_type epsilon sigma cut 格式写出全部类型对。

5.2 pair_modify shift / table

  • 所有 lj/spica 系列风格都支持 pair_modify 的 shift 选项,用于平移 LJ 部分的能量;
  • lj/spica/coul/long 还支持 pair_modify 的 table 选项——它可以把长程库仑相互作用的短程部分表格化。源码中当 ncoultablebits 非零时会调用 init_tables(cut_coul, nullptr) 构建查表(见 pair_lj_spica_coul_long.cpp)。

5.3 tail 修正:不支持

若开启 tail 修正(pair_modify tail yes),init_one() 会直接报错:Tail flag not supported by lj/spica pair style。这是由指数型粗粒化势的非标准形式决定的,使用时需关闭 tail 修正。

5.4 重启文件与 rRESPA

  • 所有 lj/spica 系列风格都会把参数写入二进制 restart 文件(write_restart/read_restart 完整保存 lj_type、epsilon、sigma、cut 以及全局设置),因此读入重启文件时无需再写 pair_style 与 pair_coeff;
  • lj/spica 与 lj/spica/coul/long 不支持 run_style respa 的 inner、middle、outer 关键字——源码中 respa_enable = 0 显式关闭了 rRESPA 支持。

六、仓库示例:SDS 单分子层与 PEG 体系

仓库在 examples/PACKAGES/cgspica 提供了两个可直接运行的示例(见 examples/PACKAGES/cgspica/README):

  • peg-verlet:粗粒化 PEG 表面活性剂/水混合层(verlet 版本),仅使用纯 LJ 项、无电荷;
  • sds-monolayer:水/汽界面的 SDS 表面活性剂单分子层,使用带库仑的 SPICA LJ 项。

6.1 组合式风格:lj/spica/coul/long

in.sds-regular 展示了带电 SDS 体系的完整配置思路:

units           real
dimension       3
atom_style      full

pair_style      lj/spica/coul/long 15.0
bond_style      harmonic
angle_style     spica
special_bonds   lj/coul 0.0 0.0 1.0

read_data       data.sds.gz

pair_coeff  1     1      lj9_6  0.7000 4.3210 # SO4  SO4
pair_coeff  1     2      lj9_6  0.3830 4.4135 # SO4  CM
pair_coeff  1     3      lj9_6  0.4050 4.4530 # SO4  CT
pair_coeff  1     4      lj12_4 1.1000 4.1000 # SO4  SOD
pair_coeff  1     5      lj12_4 1.1000 4.1000 # SO4  W
pair_coeff  2     2      lj9_6  0.4200 4.5060 # CM   CM
pair_coeff  2     3      lj9_6  0.4440 4.5455 # CT   CM
pair_coeff  2     4      lj12_4 0.3400 4.4385 # SOD  CM
pair_coeff  2     5      lj12_4 0.3400 4.4385 # W    CM
pair_coeff  3     3      lj9_6  0.4690 4.5850 # CT   CT
pair_coeff  3     4      lj12_4 0.3600 4.4780 # SOD  CT
pair_coeff  3     5      lj12_4 0.3600 4.4780 # W    CT
pair_coeff  4     4      lj12_4 0.3500 4.3710 # SOD  SOD
pair_coeff  4     5      lj12_4 0.8950 4.3710 # SOD  W
pair_coeff  5     5      lj12_4 0.8950 4.3710 # W    W

kspace_style    pppm/cg 0.00001
kspace_modify   order 3

neighbor        2.0 bin
neigh_modify    delay 4 every 2 check yes

timestep        10.0
fix             1 all nvt temp 310.0 310.0 100.0
thermo          10
run              100

要点解读:

  1. 带电珠子类型少:SDS 体系只有 SO4(类型 1)与 SOD(类型 4)带电,因此选用 pppm/cg(精度 0.00001)并配合 kspace_modify order 3;
  2. 参数显式全覆盖:5 种原子类型共 15 对参数全部显式写出,混合规则不可用;
  3. angle_style spica:与 lj/spica 配套的三体角势(见下文);
  4. special_bonds:lj/coul 0.0 0.0 1.0 表示 1-2、1-3 相互作用完全关闭,1-4 完全开启,这是粗粒化力场的通用约定;
  5. units real + 大时间步:粗粒化模型质量大、势能面平滑,常用 timestep 10.0 fs 级别的步长。

6.2 hybrid/overlay 组合式方案

in.sds-hybrid 展示了另一种等价写法——把 LJ 与库仑拆成两个独立 pair style:

pair_style hybrid/overlay  lj/sdk 15.0  coul/long 26.5
...
pair_coeff  1     4    coul/long # SO4  SOD
pair_coeff  4     4    coul/long # SOD  SOD
pair_coeff  1     1    lj/sdk  lj9_6  0.7000 4.3210 # SO4  SO4
...(其余 lj/sdk 参数与 6.1 相同)...

group charged   type 1 4
atom_modify     first charged
kspace_style    pppm/cg 0.00001

其优化思路是:只为带电类型对定义库仑项,LJ 项只覆盖全部类型对。由于带电粒子数量少,倒空间求解器只需处理"带电组"内的粒子,配合 neighbor 2.0 multi、comm_modify mode multi 可进一步压缩通信与 FFT 开销。脚本注释明确说明 lj/sdk 与 lj/spica 完全兼容、angle_style sdk 与 spica 兼容。

6.3 无静电的纯 LJ 案例

in.pegc12e8 是无电荷体系的最小模板:pair_style lj/sdk 15.0(等价于 lj/spica 15.0)+ bond_style harmonic + angle_style harmonic,仅需一个全局截断,无需 KSpace。仓库同时提供 in.pegc12e8-angle(使用 angle_style spica,含 1-3 LJ 排斥项)用于对比。

七、配套的 angle_style spica 与旧版兼容

7.1 angle_style spica

SPICA 力场中键角势不是纯谐振子,而是谐振项 + 1-3 原子对 LJ 排斥项的组合:

E = K·(θ − θ₀)² + 排斥部分

其中 K 已包含通常的 1/2 因子,θ₀ 以度为单位输入(内部转换为弧度,因此 K 的量纲为能量/弧度²)。1-3 排斥项取自非键 lj/spica 势的排斥部分,且可缩放或关闭(源码中由 repflag 控制,能量相对 lj/spica 还平移了 ε 以避免跳变)。所需的 LJ 参数(lj_type、lj1~lj4、rminsq、emin 等)会自动从 pair_style lj/spica 提取,无需重复输入;lj_spica_common.h 中预计算的 rminsq/emin 正是为此服务(见 angle_spica.cpp 与 angle_spica.rst)。示例语法:

angle_style spica
angle_coeff 1 300.0 107.0

7.2 旧名 lj/sdk 的兼容性

原实现 lj/sdk、lj/sdk/coul/long、lj/sdk/coul/msm 与 angle_style sdk 仍可用,功能与新版完全一致,仅名称不同。示例脚本中的注释(如 # "lj/sdk" is compatible with "lj/spica")印证了这一约定。

八、限制与编译要求

  1. 包依赖:所有 lj/spica 系列风格都属于 CG-SPICA 包,必须编译该包才能使用(Build_package)。lj/spica/coul/long 还额外要求编译 KSPACE 包(默认已启用);
  2. MSM 特有约束:lj/spica/coul/msm 要求 kspace_modify pressure/scalar no(见 pair_lj_spica_coul_msm.cpp);
  3. 不支持混合与 tail 修正:所有类型对必须显式给出全部系数,tail 长程修正不可用;
  4. 无 rRESPA 分层:不支持 run_style respa 的 inner/middle/outer 关键字;
  5. data 文件限制:不能直接在 data 文件中定义对参数,需通过 pair_coeff 指定,或使用 write_data ... pair ij 输出。

九、默认值与相关资料

pair_style lj/spica 系列没有默认参数(Default: none),所有截断与系数都必须显式给定。相关命令:pair_coeff、angle_style spica、kspace_style、pair_modify、read_data、read_restart、restart、run_style。

十、参考文献

  • Shinoda, DeVane, Klein, Mol Sim, 33, 27-36 (2007)(SDK 力场)
  • Shinoda, DeVane, Klein, Soft Matter, 4, 2453-2462 (2008)
  • Seo, Shinoda, J Chem Theory Comput, 15, 762-774 (2019)(SPICA 力场)
  • Miyazaki, Okazaki, Shinoda, J Chem Theory Comput, 16, 782-793 (2020)(pSPICA 力场)
登录后查看全文
lammps