LAMMPS 中 SPICA 粗粒化力场:pair_style lj/spica 系列势函数的完整使用指南
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
要点解读:
- 带电珠子类型少:SDS 体系只有 SO4(类型 1)与 SOD(类型 4)带电,因此选用
pppm/cg(精度 0.00001)并配合kspace_modify order 3; - 参数显式全覆盖:5 种原子类型共 15 对参数全部显式写出,混合规则不可用;
- angle_style spica:与
lj/spica配套的三体角势(见下文); - special_bonds:
lj/coul 0.0 0.0 1.0表示 1-2、1-3 相互作用完全关闭,1-4 完全开启,这是粗粒化力场的通用约定; - 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")印证了这一约定。
八、限制与编译要求
- 包依赖:所有
lj/spica系列风格都属于 CG-SPICA 包,必须编译该包才能使用(Build_package)。lj/spica/coul/long还额外要求编译 KSPACE 包(默认已启用); - MSM 特有约束:
lj/spica/coul/msm要求kspace_modify pressure/scalar no(见 pair_lj_spica_coul_msm.cpp); - 不支持混合与 tail 修正:所有类型对必须显式给出全部系数,tail 长程修正不可用;
- 无 rRESPA 分层:不支持
run_style respa的 inner/middle/outer 关键字; - 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 力场)