LAMMPS 自适应精度势 pair_style pace/apip 实战指南:以 ACE 势构建快速/精确双精度混合计算
LAMMPS 自适应精度势 pair_style pace/apip 实战指南:以 ACE 势构建快速/精确双精度混合计算
本文面向需要在 LAMMPS 中使用自适应精度势(Adaptive-Precision Interatomic Potential,APIP)的开发者与科研用户,系统讲解 pair_style pace/apip、pace/fast/apip、pace/precise/apip 三个变体的语法、原理、参数与完整配置流程。读完本文,你将掌握如何将昂贵的 ACE(Atomic Cluster Expansion)机器学习势与快速势(如 EAM)通过连续开关参数 λ 按原子混合,在保证精度的前提下大幅节省计算量,并能在真实算例(空位、表面等场景)中直接落地运行。
背景:ACE 势与 APIP 的核心思想
pair_style pace 基于原子簇展开(Atomic Cluster Expansion,ACE)计算相互作用。ACE 将原子能量展开为多体基函数的一般形式,是一个可以从大量 DFT 数据拟合出高精度经典势的通用方法(Drautz, Phys Rev B, 99, 014104 (2019)),其高效实现见 Lysogorskiy 等人,npj Comp Mat, 7, 97 (2021)。
机器学习势(如 ACE)精度高,但力计算开销远大于传统经验势(如 EAM,通常快 100~1000 倍)。自适应精度势(APIP)的思想是:只在局部需要的原子子集上使用昂贵的高精度势,其余原子用快速势,由每个原子 i 的连续开关参数 λᵢ ∈ 0,1] 决定两种势的权重。APIP 包的全部技术细节与参数选择方法见 [Howto APIP 与文献 Immel, Drautz and Sutmann, J Chem Phys, 162, 114119 (2025)。
对原子 i,APIP 势能定义为:
E_i^APIP = λ_i · E_i^(fast) + (1 − λ_i) · E_i^(precise)
其中 λᵢ 既可以在模拟过程中由 fix lambda/apip 动态计算,也可以在模拟开始前用 set 命令设定为常量。
三种 pace/apip 变体的分工
本命令族包含三个变体(pair_style pace/apip 官方文档):
| 变体 | 计算的势能项 | 权重因子 | 典型搭配 |
|---|---|---|---|
pace/apip |
常量精度变体,等价于 pace/precise/apip 按 (1−λᵢ)Eᵢ^(pace) 计算 |
1 − λ |
配合快速势(如 eam/fs/apip) |
pace/precise/apip |
精确势部分 (1−λᵢ)·Eᵢ^(pace) 及其力 |
1 − λ |
配合快速势(如 eam/fs/apip) |
pace/fast/apip |
快速势部分 λᵢ·Eᵢ^(pace) 及其力 |
λ |
配合精确势(如 pace/precise/apip) |
也就是说,同一份 ACE 势文件既可以扮演“快速势”也可以扮演“精确势”:
pace/precise/apip应通过 pair_style hybrid/overlay 与一个计算λᵢ·Eᵢ^(fast)的快速势组合;pace/fast/apip应通过 pair_style hybrid/overlay 与一个计算(1−λᵢ)·Eᵢ^(precise)的精确势组合。
语法与可选关键字
基本语法(三种变体相同):
pair_style pace/apip ... keyword values ...
pair_style pace/fast/apip ... keyword values ...
pair_style pace/precise/apip ... keyword values ...
可追加零个或多个来自 pair_style pace 的关键字:
| 关键字 | 取值 | 说明 |
|---|---|---|
product |
无 | 使用 product 算法计算基函数 |
recursive |
无 | 使用 recursive 算法计算基函数(默认) |
chunksize |
整数 | 每趟处理的原子数(仅 KOKKOS + GPU 有效,默认 4096,用于防止显存耗尽) |
neigh |
auto / shared / global |
构建短邻接表所用的 Kokkos team scratch 内存层级(仅 KOKKOS + GPU 有效;默认 auto 自动选择并透明回退到 level 1) |
需要注意的默认与前提(可由源码确认,见 src/APIP/pair_pace_apip.cpp):
- 默认求值器为
recursive(settings()中recursive = true); - ACE 势要求
metal单位制,若units不是 metal,settings()会直接报错"ACE potentials require 'metal' units"; - 势文件中即包含截断半径设置,截断不是通过
pair_style/pair_coeff传入的。
pair_coeff 的用法与 pair_style pace 相同:一条 pair_coeff 指定 ACE 系数文件(.yaml 或 .yace/.ace 格式),后跟 N 个元素名,把 ACE 元素映射到 LAMMPS 原子类型。ACE 系数文件路径的查找规则见 pair_coeff 页面。从源码看(pair_pace_apip.cpp 的 coeff()),.yaml 格式会被自动转换为 ACECTildeBasisSet,.yace/.ace 格式直接加载;元素名通过内置元素表(H…Lr 共 103 个元素)校验,未知元素会报错。
底层实现:λ 加权与原子级计算跳过
pace/apip 系列是在 src/ML-PACE/pair_pace.cpp 基础上修改而来(修改作者 David Immel,见 src/APIP/pair_pace_apip.cpp 文件头注释),其核心机制可以从源码中直接看到:
1. 原子级跳过(abort condition)——这是 APIP 省时间的根本。pair_pace_apip.cpp 中 check_abort_condition() 判断:若 λᵢ == 1(且无本地恒温器修正需求),精确势权重 1−λᵢ = 0,该原子的 ACE 计算可以整段跳过:
int PairPACEAPIP::check_abort_condition(double *lambda, double *lambda_const, int *lambda_required, int i)
{
if ((lambda[i] == 1) && ((!lambda_thermostat) || (lambda_thermostat && lambda_const[i] == 1))) {
lambda_required[i] |= ApipLambdaRequired::NO_COMPLEX;
return 1; // 不需要复杂(精确)势计算
}
lambda_required[i] |= ApipLambdaRequired::COMPLEX;
return 0;
}
pace/fast/apip(src/APIP/pair_pace_fast_apip.cpp)则反过来:当 λᵢ == 0 时跳过快速势计算,权重因子 compute_factor_lambda() 返回 λ;而 pace/precise/apip(src/APIP/pair_pace_precise_apip.cpp)与 pace/apip 的权重因子返回 1−λ。对应的 λ_required 位标志(SIMPLE/NO_SIMPLE/COMPLEX/NO_COMPLEX)定义在 src/APIP/atom_vec_apip.h。
2. 能量参考存储——get_e_ref_ptr() 把未加权的 ACE 原子能量写入 atom->apip_e_precise(精确变体)或 atom->apip_e_fast(快速变体),供本地恒温器等下游组件做能量修正。
3. 计算计时——每个变体通过 extract("pace/apip:time_per_atom") 等接口暴露平均单原子计算时间,供 fix atom_weight/apip 做负载估算,进而配合 fix balance 做动态负载均衡。
4. 其他继承能力——pair_style pace 的内核排斥(ZBL core-repulsion)能力同样保留:extract_peratom("corerep") 返回逐原子数组 corerep_factor = 1 − fcut,表示每个原子处于 ZBL 核心排斥的比例,可用 fix pair ... corerep 1 触发(参见 pair_pace.rst 的 Core repulsion 一节)。
完整输入脚本实战:三种开关模式
按 Howto APIP 的说明,运行 APIP 模拟需要按模式组合以下组件。三种模式均要求使用 atom_style apip(其默认参数为 thermostat,保守方案用 atom_style apip conservative,见 atom_style.rst),并用 comm_style tiled 以支持 fix balance 的 rcb 风格。
模式一:保守的动态开关(可微开关参数)
使用可微分的开关参数(对可微描述子做局部平均,如局部平均 CSP),势能天然保守,无需能量修正。示例(来自 Howto_apip.rst):
atom_style apip conservative
comm_style tiled
pair_style hybrid/overlay eam/fs/apip pace/precise/apip
pair_coeff * * eam/fs/apip Cu.eam.fs Cu
pair_coeff * * pace/precise/apip Cu.yace Cu
# 用局部平均的 CSP 计算可微开关参数,得到保守势
fix 2 all lambda/la/csp/apip 0.24 1.5 11.0 12.0 bcc
fix 4 all atom_weight/apip 100 eam ace 0 0 all
variable myweight atom f_4
fix 5 all balance 100 1.1 rcb weight var myweight
其中 fix lambda/la/csp/apip 的关键字 forces yes 会计算开关参数微分引入的力,从而满足 F_i = −∇ᵢ Σⱼ Eⱼ 的保守性。
模式二:动态开关 + 本地恒温器能量修正(非保守开关)
这是文档 pair_pace_apip.rst 主示例使用的模式,适用于性能优先、用校正补偿能量守恒的场景,由五个组件构成:lambda/input(计算 λ 输入)→ fix lambda/apip(计算开关参数)→ lambda/zone(空间过渡区)→ fix lambda_thermostat/apip(能量修正)→ hybrid/overlay(组合势):
atom_style apip
comm_style tiled
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
fix 3 all lambda_thermostat/apip N_rescaling 200
fix 4 all atom_weight/apip 100 eam ace lambda/input lambda/zone all
variable myweight atom f_4
fix 5 all balance 100 1.1 rcb weight var myweight
各组件要点如下:
- pair_style lambda/input/csp/apip:
fcc/bcc/整数 N 指定参与 CSP(中心对称参数,参见 compute centro/atom)计算的近邻数;可选cutoff(默认 5.0)与N_buffer(默认 0)关键字。lambda/input/apip变体则恒置λᵢ^input = 0。 - fix lambda/apip:
thr_lo thr_hi是两个阈值,λᵢ^input 低于thr_lo时开关参数为 1(纯快速势),高于thr_hi时为 0(纯精确势),中间用截断函数平滑过渡。可选关键字time_averaged_zone cut_lo cut_hi history_len_lambda_input history_len_lambda(默认 4.0 / 12.0 / 100 / 100)、min_delta_lambda(默认 0)、lambda_non_group precise|fast|float(默认 1)、group_fast、group_precise、group_ignore_lambda_input、store_atomic_stats、dump_atomic_history。 - pair_style lambda/zone/apip:只取一个全局
cutoff,计算空间过渡区 λ_min,i;真正的半径 r_λ,lo / r_λ,hi 由fix lambda/apip的time_averaged_zone定义,二者必须在输入脚本中共存。 - fix lambda_thermostat/apip:当开关参数更新而力计算中忽略其梯度时,用本地恒温器补偿能量守恒偏差;关键字
seed、store_atomic_forces nevery、N_rescaling groupsize(重标定近邻原子数,>1)。注意它不是常规控温器。
模式三:恒定开关参数
模拟前用 set 命令固定每个原子的 λᵢ,势能保守且实现最简单:
atom_style apip
comm_style tiled
pair_style hybrid/overlay eam/fs/apip pace/precise/apip
pair_coeff * * eam/fs/apip Cu.eam.fs Cu
pair_coeff * * pace/precise/apip Cu.yace Cu
# 计算 lambda 的某种方式
variable lambda atom ...
set group all apip/lambda v_lambda
fix 4 all atom_weight/apip 100 eam ace 0 0 all
variable myweight atom f_4
fix 5 all balance 100 1.1 rcb weight var myweight
ACE-ACE 组合
若快速势也用 ACE,只需把上述脚本中的快速项替换为 pace/fast/apip。仓库 examples/PACKAGES/apip/in.vacancy.dynamic.lambda 中给出了被注释的等价写法:
pair_style hybrid/overlay pace/fast/apip pace/precise/apip lambda/input/csp/apip fcc cutoff 6.0 lambda/zone/apip 12.0
pair_coeff * * pace/fast/apip Cu-1.yace Cu
pair_coeff * * pace/precise/apip ../../../potentials/Cu-PBE-core-rep.ace Cu
pair_coeff * * lambda/input/csp/apip
pair_coeff * * lambda/zone/apip
仓库示例:从验证到真实场景
APIP 包自带的算例位于 examples/PACKAGES/apip/(其 README 说明了每个算例的用途):
- in.validate:同一套体系依次用纯 ACE(
pair_style pace)、APIP 全精确(set group all apip/lambda precise)、APIP 全快速(set group all apip/lambda fast)、纯 EAM 四种配置跑run 0,用于验证 APIP 实现与两端势的一致性和能量等价性。 - in.vacancy.const.lambda:含空位的铜体系,把原子分成 vacancy / transition / bulk 三个 group,分别
set apip/lambda precise / 0.5 / fast,演示恒定开关参数的 APIP(EAM-ACE 组合,即eam/fs/apip+pace/apip),并演示用compute property/atom apip_lambda统计各类原子的数量。 - in.vacancy.dynamic.lambda:同一体系改用
fix lambda/apip动态计算开关参数,CSP 作为检测机制(csp_lattice fcc、csp_cutoff 6.0),并演示 fix lambda_thermostat/apip 补偿能量、write_restart平滑重启(λ 与 λ^input 的历史都写入二进制重启文件)。 - in.surface.balance:更真实的表面体系。只让上层表面被精确处理(用
region bottom配合group_ignore_lambda_input忽略底层原子的 CSP 输入),并演示fix atom_weight/apip+fix balance的动态负载均衡(rcb weight var myweight)。
这些算例还配套了 .eam.fs、.yace、.ace 势文件(如 Cu_300K_Immel_2023.eam.fs、Cu-1.yace),可直接替换 pair_coeff 中的文件名运行。
限制与注意事项
以下限制与原文档(pair_pace_apip.rst)及源码一致,配置时务必留意:
- 单位制:ACE 势按 metal 单位参数化,
units metal是强制前提。 - 原子样式:
init_style()要求开启 atom IDs(tag_enable)与newton pair on,并要求使用带lambda/lambda_required的原子样式,即atom_style apip(详见 atom_style.rst 与 atom_vec_apip.h)。 - 混合(mixing):对 I≠J 的不同元素类型对,混合由 LAMMPS 自动完成,无需为 I≠J 指定
pair_coeff。 - pair_modify:不支持
shift、table、tail选项。 - 重启文件:这些 pair style 不把信息写入二进制重启文件(势参数存在势文件中),因此读重启文件时必须重新给出
pair_style与pair_coeff命令;不过fix lambda/apip的 λ 与 λ^input 历史会写入重启文件以保证平滑续算。 - rRESPA:只能通过
run_style respa的pair关键字使用,不支持inner/middle/outer关键字。 - 依赖:
pace/apip需要 ML-PACE 包的 lib/pace 库(见 src/APIP/README 与 src/ML-PACE/README),且整个 APIP 包需要单独编译启用。
构建要求
这些 pair style 属于 APIP 包(src/APIP/),只有当 LAMMPS 编译时启用了该包才可用;而 pace/apip 还需先安装 ML-PACE 包的 lib/pace 库。包安装与构建的具体步骤见 Build package 页面。APIP 包的安装脚本与全部源码位于 src/APIP/Install.sh 与 src/APIP/ 目录。
相关命令
与 pace/apip 配套使用或功能相关的命令包括:pair_style pace、pair_style hybrid/overlay、fix lambda/apip、fix lambda_thermostat/apip、fix lambda/la/csp/apip、pair_style lambda/zone/apip、pair_style lambda/input/apip、pair_style eam/apip、fix atom_weight/apip 与 fix balance。完整的组合工作流与三种开关模式的选择建议,建议进一步阅读 Howto APIP。
参考文献
- Drautz, Phys Rev B, 99, 014104 (2019)。
- Lysogorskiy, van der Oord, Bochkarev, Menon, Rinaldi, Hammerschmidt, Mrovec, Thompson, Csanyi, Ortner, Drautz, npj Comp Mat, 7, 97 (2021)。
- Immel, Drautz and Sutmann, J Chem Phys, 162, 114119 (2025)。
- Kelchner, Plimpton, Hamilton, Phys Rev B, 58, 11085 (1998)(CSP 原始出处)。