LAMMPS APIP 系列之 pair_style lambda/input/apip:自适应精度势的切换输入计算详解

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

LAMMPS APIP 系列之 pair_style lambda/input/apip:自适应精度势的切换输入计算详解

导读:本文以 LAMMPS 官方文档 pair_lambda_input_apip.rst 为核心,系统讲解 APIP(Adaptive-Precision Interatomic Potentials,自适应精度原子间势)中负责提供切换参数输入量 λiinput(t)\lambda_i^{\text{input}}(t) 的 pair style——lambda/input/apip 与其 CSP 变体 lambda/input/csp/apip。读者将掌握:这两个 pair style 的完整语法与参数语义、它们如何与 fix lambda/apip、pair_style lambda/zone/apip 协作构成完整的动态切换参数计算链路,以及如何结合仓库中的源码与真实示例(如 EAM-ACE 混合势)搭建一套可运行的 APIP 模拟。本文适用于希望在大规模 MD 模拟中以"局部高精度、其余快速势"方式提升效率的 LAMMPS 用户。

一、APIP 与 λiinput\lambda_i^{\text{input}} 在全局中的角色

APIP 包(见 Packages_details.rst 中的 APIP 一节与 Howto_apip.rst)的核心思想是:用一个快速势(如 EAM)和一个人工智能势(如 ACE)同时描述体系,通过每个原子 ii 的连续切换参数 λi∈[0,1]\lambda_i \in [0,1] 决定该原子采用哪种精度:

Ei=λiEi(fast)+(1−λi)Ei(precise),E_i = \lambda_i E_i^{\text{(fast)}} + (1-\lambda_i) E_i^{\text{(precise)}},

其中 λi=1\lambda_i=1 表示只用快速势,λi=0\lambda_i=0 表示只用精确势。pair_style lambda/input/apip 及其变体正是"输入量"的提供者:它计算 λiinput(t)\lambda_i^{\text{input}}(t),而该输入量随后被 fix lambda/apip 转化为最终的切换参数 λi\lambda_i。

两个风格的职责定位如下:

  • pair_style lambda/input/apip:最简单的输入源,直接设置 λiinput(t)=0\lambda_i^{\text{input}}(t) = 0(不进行任何检测,所有原子按"精确"端处理);
  • pair_style lambda/input/csp/apip:基于中心对称参数(CSP,centro-symmetry parameter)计算 λiinput(t)=CSPi(t)\lambda_i^{\text{input}}(t) = \text{CSP}_i(t),用于自动识别缺陷、表面等"需要精确处理"的局部区域,是实际 APIP 模拟中最常使用的输入检测机制。

按 Howto_apip.rst 的说明,采用"动态切换参数 + 能量修正"(dynamic switching parameter with correction)的模拟方案,必须按以下顺序组合各组件:

  1. atom_style apip(存储 λi\lambda_i 等逐原子量,见 atom_style.rst 中 apip 一栏);
  2. 快速势 eam/apip 或 pace/fast/apip(见 pair_eam_apip.rst、pair_pace_apip.rst);
  3. 精确势 pace/precise/apip;
  4. 本文主角 pair_style lambda/input/apip 计算 λiinput\lambda_i^{\text{input}};
  5. fix lambda/apip 把 λiinput\lambda_i^{\text{input}} 换算为 λi\lambda_i;
  6. pair_style lambda/zone/apip 计算切换参数的空间过渡区;
  7. pair_style hybrid/overlay 组合以上所有 pair styles;
  8. fix lambda_thermostat/apip 在切换参数变化时修正能量;
  9. fix atom_weight/apip + fix balance 做基于计算负载的动态负载均衡。

二、语法与参数详解

2.1 pair_style lambda/input/apip

基本语法:

pair_style lambda/input/apip cutoff
  • lambda/input/apip:该 pair style 的名称;
  • cutoff:全局截断距离(距离单位)。

2.2 pair_style lambda/input/csp/apip

基本语法:

pair_style lambda/input/csp/apip lattice keyword args ...
  • lattice:fcc 或 bcc 或整数。
    • fcc:按完美 fcc 晶格取 12 个最近邻计算 CSP;
    • bcc:按完美 bcc 晶格取 8 个最近邻计算 CSP;
    • 整数:使用 N 个最近邻计算 CSP(须为正偶数,见下文源码约束);
  • 可追加零个或多个 keyword/args 对:
    • cutoff args = cutoff:考虑邻近原子为邻居的距离(必须 > 0);
    • N_buffer args = N_buffer:在 j 与 j+N/2 配对计算中额外包含的邻居数。

2.3 参数默认值与源码级约束

文档原文 明确给出的默认值为:N_buffer=0,cutoff=5.0。

在 pair_lambda_input_csp_apip.cpp 的 settings() 中,除了解析参数,还会做如下合法性校验(可直接作为实战中的取值约束):

  • nnn <= 1 || nnn % 2 时报错:CSP 计算要求邻居数必须是 大于 1 的偶数(因为需要两两配对 j,j+N/2j, j+N/2);
  • cut_csp <= 0 时报错:截断必须为正;
  • nnn_buffer < 0 时报错:缓冲区邻居数不能为负。

fcc/bcc 关键字在源码中分别被解析为 nnn = 12 和 nnn = 8,与 compute centro/atom 的约定完全一致——后者正是 CSP 的原始定义出处(Kelchner, Plimpton & Hamilton, Phys Rev B, 58, 11085 (1998))。

2.4 配套的 pair_coeff

与普通 pair style 不同,这两个风格不需要任何势参数文件,其 pair_coeff 只需给出原子类型范围,源码 pair_lambda_input_apip.cpp 的 coeff() 仅接受两个参数(i 类型范围、j 类型范围),例如 pair_coeff * * lambda/input/csp/apip。

三、官方示例代码

文档给出的小节示例(注意结合 hybrid/overlay 完整使用):

pair_style hybrid/overlay eam/fs/apip pace/precise/apip lambda/input/csp/apip fcc cutoff 5.0 lambda/zone/apip 12.0
pair_coeff * * eam/fs/apip Cu.eam.fs Cu
pair_coeff * * pace/precise/apip Cu_precise.yace Cu
pair_coeff * * lambda/input/csp/apip
pair_coeff * * lambda/zone/apip
fix 2 all lambda/apip 3.0 3.5 time_averaged_zone 4.0 12.0 110 110 min_delta_lambda 0.01

其中:eam/fs/apip 提供快速势,pace/precise/apip 提供精确势,lambda/input/csp/apip fcc cutoff 5.0 用 fcc 构型的 CSP 作为输入,lambda/zone/apip 12.0 负责空间过渡区(注意它的截断只用于邻居列表构建,真正的过渡区半径由 fix lambda/apip 的 time_averaged_zone 参数定义,见 pair_lambda_zone_apip.rst 中的警告),fix lambda/apip 完成从输入到 λi\lambda_i 的最终换算。

仓库中的真实运行示例更进一步。以 examples/PACKAGES/apip/in.vacancy.dynamic.lambda 为例(空位体系的动态切换参数模拟):

variable	csp_lattice string "fcc"
variable	csp_cutoff equal 6.0
variable	r_sw_lo equal 2.0
variable	r_sw_hi equal 3.0
variable	lambda_input_thr_lo equal 2.5
variable	lambda_input_thr_hi equal 3.0
variable	lambda_input_histlen equal 110
variable	lambda_histlen equal 110
variable	min_delta_lambda equal 1/${lambda_histlen}
variable	N_rescaling equal 600

units		metal
atom_style	apip
timestep	0.001
read_data	data.vacancy
fix		nve all nve

pair_style	hybrid/overlay eam/fs/apip pace/apip lambda/input/csp/apip ${csp_lattice} cutoff ${csp_cutoff} lambda/zone/apip ${r_sw_hi}
pair_coeff	* * eam/fs/apip ${eamfs_file} Cu
pair_coeff	* * pace/apip ${ace_file2} Cu
pair_coeff	* * lambda/input/csp/apip
pair_coeff	* * lambda/zone/apip
fix		lambda all lambda/apip ${lambda_input_thr_lo} ${lambda_input_thr_hi} time_averaged_zone ${r_sw_lo} ${r_sw_hi} ${lambda_input_histlen} ${lambda_histlen} min_delta_lambda ${min_delta_lambda}
fix		lambda_thermostat all lambda_thermostat/apip N_rescaling ${N_rescaling} store_atomic_forces 100

compute		lambda all property/atom apip_lambda
compute		lambda_input all property/atom apip_lambda_input
variable	flag_simple atom c_lambda==1
variable	flag_switch atom c_lambda<1&&c_lambda>0
variable	flag_complex atom c_lambda==0
compute		lambda_types all reduce sum v_flag_simple v_flag_switch v_flag_complex
thermo_style	custom step etotal c_lambda_types[*]
run		100

该示例展示了几个实用要点:

  • 必须使用 atom_style apip,它提供 apip_lambda、apip_lambda_input 等逐原子数组(atom_vec_apip.cpp 中 process_args 按 thermostat/conservative 模式分别注册字段,其中 apip_lambda_input 仅在 thermostat 模式下分配);
  • 空位/缺陷附近原子的 CSP 值高,会被判为"精确区"(λ→0\lambda\to 0),完美晶格区 CSP≈0 则落入"快速区"(λ=1\lambda=1);
  • 通过 compute property/atom apip_lambda 与 apip_lambda_input 可以随时统计 fast/switch/complex 三类原子的数目,作为参数标定的反馈;
  • 注释中还演示了 write_restart + read_restart 的平滑续算方式——切换参数的历史记录会被保存到二进制重启文件(见第四节)。

另一个示例 examples/PACKAGES/apip/in.surface.balance 则展示了如何结合空间区域忽略输入计算:

region		bottom block INF INF INF INF INF 0 units box
group		group_ignore_csp region bottom

pair_style	hybrid/overlay eam/fs/apip pace/apip lambda/input/csp/apip fcc cutoff 6.0 lambda/zone/apip 12.0
...
fix		lambda all lambda/apip 7.5 8.0 time_averaged_zone 4.0 12.0 110 110 min_delta_lambda 0.0091 group_ignore_lambda_input group_ignore_csp
fix		weight_atom all atom_weight/apip 10 eam ace lambda/input lambda/zone all
variable	myweight atom f_weight_atom
comm_style	tiled
fix		balance all balance 10 0.9 rcb weight var myweight weight store usedweight

这里用 group_ignore_lambda_input 让底部区域的原子跳过 λiinput\lambda_i^{\text{input}} 计算(源码 pair_lambda_input_csp_apip.cpp 中,命中该组位掩码的原子直接 lambda_input[i] = 0 并 continue),再结合 fix atom_weight/apip + fix balance rcb 完成负载均衡——这正是文档强调的"把输入计算纳入负载均衡"的完整落地形态。

四、工作原理:从源码看 λiinput\lambda_i^{\text{input}} 如何被计算与消费

4.1 lambda/input/apip:恒为 0 的输入

基类 pair_lambda_input_apip.cpp 的 calculate_lambda_input() 遍历邻居列表中的每个本地原子,直接写入 atom->apip_lambda_input[i] = 0,即 λiinput=0\lambda_i^{\text{input}}=0。

这里的关键点在于它与 fix lambda/apip 的配合方式:compute() 在计算完输入后立即调用 fix_lambda->update_lambda_input_history()(见 pair_lambda_input_apip.cpp),把新输入推进 fix 内部的滑动历史窗口。因此输入计算由 pair style 完成、历史管理与换算由 fix 完成,这也是文档明确说明"计算放在 pair_style 而非 fix 中,是因为该计算耗时且可被 fix atom_weight/apip 计入负载均衡"的原因。

4.2 lambda/input/csp/apip:CSP 的逐原子实现

在 pair_lambda_input_csp_apip.cpp 中,calculate_lambda_input() 复刻了 compute centro/atom 的 CSP 定义:

CS=∑i=1N/2∣R⃗i+R⃗i+N/2∣2,\text{CS} = \sum_{i=1}^{N/2} |\vec{R}_i + \vec{R}_{i+N/2}|^2,

其实现要点如下:

  1. 邻居筛选:对每个原子遍历全邻居列表,但距离过滤使用的是独立的 cut_csp_sq = cut_csp² 而非 cutsq——源码注释明确说明这是因为 cutsq 可能因 lambda/zone/apip 的更大搜索半径而偏大,不能用于 CSP 邻居挑选;
  2. 最近邻排序:用数值方法(源码中的 select2/select,改编自 Numerical Recipes 的选择算法)在 nnn_all = nnn + nnn_buffer 个最近邻中选出所需的子集;
  3. 配对求值:构造 npairs=Nall(Nall−1)/2n_{\text{pairs}} = N_{\text{all}}(N_{\text{all}}-1)/2 个原子对,对每个对计算 ∣R⃗j+R⃗k−2R⃗i∣2|\vec{R}_j + \vec{R}_k - 2\vec{R}_i|^2,再取最小的 N/2N/2 个求和——这是"对称相对位置配对贡献最小"这一物理直觉的数学实现;
  4. 边界处理:若某原子在截断内的邻居数不足 NallN_{\text{all}},无法形成 N/2N/2 个配对,则直接把输入设为 1000.0 这一高值——高 CSP 意味着该原子位于表面/缺陷/孤立区,从而被判定为需要精确势处理(λi→0\lambda_i\to 0)。

这与 compute centro/atom 文档中给出的 CSP 量级参考一致:完整晶格约 0,位错芯约 1.0(0.5–1.25),层错约 5.0(4.0–6.0),自由表面约 23.0。这些未归一化的数值直接决定了 fix lambda/apip 中阈值 thr_lo/thr_hi 的物理含义:CSP 低于 thr_lo 的原子用快速势(λ=1\lambda=1),高于 thr_hi 的原子用精确势(λ=0\lambda=0),两者之间为过渡区。

4.3 从输入到最终切换参数的完整链路

fix_lambda_apip.cpp 中可以看到输入量被消费的四步流程(其初始化要求:必须恰好存在一个 fix lambda/apip、一个 pair lambda_input、一个 pair lambda/zone/apip,且原子风格需带 lambda_input 等标志位,见 fix_lambda_apip.cpp):

  1. 时间平均输入:update_lambda_input_history() 把 λ_input 推入长度为 history_len_lambda_input 的环形历史,维护滑动和,得到 λavg,iinput\lambda^{\text{input}}_{\text{avg},i}(fix_lambda_apip.cpp);
  2. 阈值映射:用文档给出的 cutoff 函数计算 λ0,i(t)=f(cut)((λavg,iinput−λloinput)/(λhiinput−λloinput))\lambda_{0,i}(t) = f^{\text{(cut)}}\big((\lambda^{\text{input}}_{\text{avg},i}-\lambda_{\text{lo}}^{\text{input}})/(\lambda_{\text{hi}}^{\text{input}}-\lambda_{\text{lo}}^{\text{input}})\big)。源码 fix_lambda_apip.cpp 的 switching_function_poly 采用七次多项式,在过渡区边界处前两阶导数均为 0,从而保证切换平滑;
  3. 空间过渡区:pair_style lambda/zone/apip 对每个原子在其邻居中搜索最小 λ\lambda,实现 λmin⁡,i(t)\lambda_{\min,i}(t) 的空间扩展(pair_lambda_zone_apip.cpp 的 calculate_lambda() 中,对每个"非 simple"邻居对用距离相关的多项式切换函数做局部最小值传播,其 cut_lo/cut_hi 直接从 fix lambda/apip 通过 extract() 读取);
  4. 时间平滑与抖动抑制:对 λmin⁡,i\lambda_{\min,i} 再做 history_len_lambda 步滑动平均,最后用 min_delta_lambda 阈值抑制数值抖动——只有当平均值的改变量超过该阈值(或值恰为 0/1)时才更新 λi\lambda_i(fix_lambda_apip.cpp 的 post_integrate)。

4.4 与负载均衡的集成

文档强调输入计算"可以被 fix atom_weight/apip 纳入负载均衡"。这一机制在源码中有两处直接体现:

  • 本 pair style 的 extract() 提供 "lambda/input/apip:time_per_atom",内部累计 timer 与 n_calculations 并给出单次计算的均摊耗时(pair_lambda_input_apip.cpp);
  • fix_atom_weight_apip.cpp 在 pre_exchange 阶段提取 lambda/input/apip:time_per_atom 与 lambda/zone/apip:time_per_atom,结合快速/精确势的每原子耗时,为每个原子合成一个计算负载权重,供 fix balance 使用。

fix lambda/apip 的默认参数(fix_lambda_apip.rst)与本文档中的默认值共同构成推荐的起点:min_delta_lambda = 0、lambda_non_group = 1、cut_lo = 4.0、cut_hi = 12.0、history_len_lambda_input = 100、history_len_lambda = 100。

五、Mixing、restart 与 rRESPA 注意事项

文档在"Mixing, shift, table, tail correction, restart, rRESPA info"一节中明确了几项工程约束,实践时必须遵守:

  • 截断混合:本 pair style 的截断距离可被混合,默认混合方式为 geometric(参见 pair_modify 命令);
  • 不支持 pair_modify 选项:shift、table、tail 三个选项均不支持;
  • 不写二进制重启文件:该 pair style 不向 restart 文件写入任何信息,因此读取重启文件继续模拟时,必须重新在输入脚本中显式指定 pair_style 与 pair_coeff 命令。值得注意的是,fix lambda/apip 本身会把 λi\lambda_i 与 λiinput\lambda_i^{\text{input}} 的历史写入重启文件以支持平滑续算(见 fix_lambda_apip.rst 与 fix_lambda_apip.cpp),示例脚本 in.vacancy.dynamic.lambda 的注释部分即演示了这一"restart + 重新指定 pair 命令"的续算流程;
  • 不支持 rRESPA:run_style respa 的 inner、middle、outer 关键字在本 pair style 上不可用。

六、限制、依赖与相关命令

参考文献:本文档引用的核心文献为 Kelchner, Plimpton & Hamilton, Phys Rev B, 58, 11085 (1998)(CSP 定义),以及 Immel, Drautz & Sutmann, J Chem Phys, 162, 114119 (2025)(APIP 方法及 N_buffer 相关讨论)。实际选择 thr_lo/thr_hi/cut_lo/cut_hi/历史长度等参数时,建议以该文献中的标定方法为准,并利用示例脚本中的 compute reduce 统计 fast/switch/complex 原子比例作为反馈。

登录后查看全文
lammps