LAMMPS APIP 系列之 pair_style lambda/input/apip:自适应精度势的切换输入计算详解
LAMMPS APIP 系列之 pair_style lambda/input/apip:自适应精度势的切换输入计算详解
导读:本文以 LAMMPS 官方文档 pair_lambda_input_apip.rst 为核心,系统讲解 APIP(Adaptive-Precision Interatomic Potentials,自适应精度原子间势)中负责提供切换参数输入量 的 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 与 在全局中的角色
APIP 包(见 Packages_details.rst 中的 APIP 一节与 Howto_apip.rst)的核心思想是:用一个快速势(如 EAM)和一个人工智能势(如 ACE)同时描述体系,通过每个原子 的连续切换参数 决定该原子采用哪种精度:
其中 表示只用快速势, 表示只用精确势。pair_style lambda/input/apip 及其变体正是"输入量"的提供者:它计算 ,而该输入量随后被 fix lambda/apip 转化为最终的切换参数 。
两个风格的职责定位如下:
pair_style lambda/input/apip:最简单的输入源,直接设置 (不进行任何检测,所有原子按"精确"端处理);pair_style lambda/input/csp/apip:基于中心对称参数(CSP,centro-symmetry parameter)计算 ,用于自动识别缺陷、表面等"需要精确处理"的局部区域,是实际 APIP 模拟中最常使用的输入检测机制。
按 Howto_apip.rst 的说明,采用"动态切换参数 + 能量修正"(dynamic switching parameter with correction)的模拟方案,必须按以下顺序组合各组件:
atom_style apip(存储 等逐原子量,见 atom_style.rst 中 apip 一栏);- 快速势
eam/apip或pace/fast/apip(见 pair_eam_apip.rst、pair_pace_apip.rst); - 精确势
pace/precise/apip; - 本文主角
pair_style lambda/input/apip计算 ; fix lambda/apip把 换算为 ;pair_style lambda/zone/apip计算切换参数的空间过渡区;pair_style hybrid/overlay组合以上所有 pair styles;fix lambda_thermostat/apip在切换参数变化时修正能量;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对:cutoffargs = cutoff:考虑邻近原子为邻居的距离(必须 > 0);N_bufferargs = 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 的偶数(因为需要两两配对 );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 完成从输入到 的最终换算。
仓库中的真实运行示例更进一步。以 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 值高,会被判为"精确区"(),完美晶格区 CSP≈0 则落入"快速区"();
- 通过
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 让底部区域的原子跳过 计算(源码 pair_lambda_input_csp_apip.cpp 中,命中该组位掩码的原子直接 lambda_input[i] = 0 并 continue),再结合 fix atom_weight/apip + fix balance rcb 完成负载均衡——这正是文档强调的"把输入计算纳入负载均衡"的完整落地形态。
四、工作原理:从源码看 如何被计算与消费
4.1 lambda/input/apip:恒为 0 的输入
基类 pair_lambda_input_apip.cpp 的 calculate_lambda_input() 遍历邻居列表中的每个本地原子,直接写入 atom->apip_lambda_input[i] = 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 定义:
其实现要点如下:
- 邻居筛选:对每个原子遍历全邻居列表,但距离过滤使用的是独立的
cut_csp_sq = cut_csp²而非cutsq——源码注释明确说明这是因为cutsq可能因lambda/zone/apip的更大搜索半径而偏大,不能用于 CSP 邻居挑选; - 最近邻排序:用数值方法(源码中的
select2/select,改编自 Numerical Recipes 的选择算法)在nnn_all = nnn + nnn_buffer个最近邻中选出所需的子集; - 配对求值:构造 个原子对,对每个对计算 ,再取最小的 个求和——这是"对称相对位置配对贡献最小"这一物理直觉的数学实现;
- 边界处理:若某原子在截断内的邻居数不足 ,无法形成 个配对,则直接把输入设为
1000.0这一高值——高 CSP 意味着该原子位于表面/缺陷/孤立区,从而被判定为需要精确势处理()。
这与 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 的原子用快速势(),高于 thr_hi 的原子用精确势(),两者之间为过渡区。
4.3 从输入到最终切换参数的完整链路
fix_lambda_apip.cpp 中可以看到输入量被消费的四步流程(其初始化要求:必须恰好存在一个 fix lambda/apip、一个 pair lambda_input、一个 pair lambda/zone/apip,且原子风格需带 lambda_input 等标志位,见 fix_lambda_apip.cpp):
- 时间平均输入:
update_lambda_input_history()把λ_input推入长度为history_len_lambda_input的环形历史,维护滑动和,得到 (fix_lambda_apip.cpp); - 阈值映射:用文档给出的 cutoff 函数计算 。源码 fix_lambda_apip.cpp 的
switching_function_poly采用七次多项式,在过渡区边界处前两阶导数均为 0,从而保证切换平滑; - 空间过渡区:
pair_style lambda/zone/apip对每个原子在其邻居中搜索最小 ,实现 的空间扩展(pair_lambda_zone_apip.cpp 的calculate_lambda()中,对每个"非 simple"邻居对用距离相关的多项式切换函数做局部最小值传播,其cut_lo/cut_hi直接从fix lambda/apip通过extract()读取); - 时间平滑与抖动抑制:对 再做
history_len_lambda步滑动平均,最后用min_delta_lambda阈值抑制数值抖动——只有当平均值的改变量超过该阈值(或值恰为 0/1)时才更新 (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本身会把 与 的历史写入重启文件以支持平滑续算(见 fix_lambda_apip.rst 与 fix_lambda_apip.cpp),示例脚本in.vacancy.dynamic.lambda的注释部分即演示了这一"restart + 重新指定 pair 命令"的续算流程; - 不支持 rRESPA:
run_style respa的 inner、middle、outer 关键字在本 pair style 上不可用。
六、限制、依赖与相关命令
- 包依赖:该功能属于 APIP 包(源码位于 src/APIP),只有用 APIP 包构建的 LAMMPS 才可用;构建方法参见 Build_package.rst。此外,APIP 包要求同时安装 ML-PACE 包及其
lib/pace依赖(见 Packages_details.rst 中 APIP 一节的 Install 说明与 src/APIP/README); - 原子风格要求:使用本 pair style 必须搭配
atom_style apip(thermostat 模式),否则init_style()会因缺少apip_lambda_input_flag而直接报错(pair_lambda_input_apip.cpp); - fix 数量约束:模拟中必须恰好存在一个
fix lambda/apip,且该 fix 会强制要求同时定义pair lambda_input与pair lambda/zone/apip; - 相关命令(完整列表见文档末尾):compute centro/atom、fix lambda/apip、fix lambda_thermostat/apip、pair_style lambda/zone/apip、pair_style eam/apip、pair_style pace/apip、fix atom_weight/apip。
参考文献:本文档引用的核心文献为 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 原子比例作为反馈。