PLUMED ABMD棘轮偏置与个人兼容入口
用11帧距离轨迹演示ABMD的历史最小值、MIN参数和受力,区分原版受力残留与个人插件的实际结果。
阅读本篇目录
下载完整输入、实际输出、个人插件源码、数据和图片(ZIP)。ABMD适合了解“允许靠近目标,抑制回退”的偏置思路。本例先准备11帧两原子距离,用PLUMED的driver离线处理,再读历史最小值、偏置能和受力;不是受偏置驱动的MD,也不用于报告自由能。
1 先看已有结果#
解压进入plumed-ABMD-local,执行:
bash read.sh
bash plot.sh
head -6 analysis/PLUMED-ABMD-history-energy-forces.csv

两组各11帧,距离依次为2.0、1.8、1.9、1.6、1.7、1.2、1.4、1.0、0.9、1.1、1.0 nm。目标为1.0 nm;既包含逐步靠近,也包含回退和越过目标。横轴是指定帧编号,不是实际MD运行时间。
2 自己构建并运行一次#
bash build.sh
bash run.sh
bash read.sh work-new analysis-new
bash plot.sh analysis-new
构建和后处理均为单进程、单线程。本例使用集群PLUMED2.10.1及其匹配的mklib环境构建个人ABMD_Local.so,编译器为Intel oneAPI C++2024.2.1,MPI为IntelMPI2021.13;公共内核和模块不变,下载包不附已编译的动态库。源码保留原作者版权和LGPL许可证,换PLUMED版本后需要重新核对和构建。
build.sh若找不到未版本化的zlib开发链接,只在本例自己的build-libs连接已安装的libz.so.1,供这次编译使用。它不安装系统包。run.sh在新的work-new处理两组输入,已有工作目录时停止,不覆盖结果。
3 完整PLUMED输入#
inputs/automatic-min/plumed.dat为:
LOAD FILE=../../ABMD_Local.so
UNITS LENGTH=nm ENERGY=kj/mol TIME=ps
d: DISTANCE ATOMS=1,2 NOPBC
a: ABMD_LOCAL ARG=d TO=1.0 KAPPA=50
PRINT ARG=d,a.bias,a.d_min,a.force2 STRIDE=1 FILE=COLVAR FMT=%24.16e
DUMPFORCES ARG=d FILE=cvforces.dat STRIDE=1 FMT=%24.16e
另一组只在ABMD_LOCAL行增加MIN=0.25。这里MIN是距离偏差平方的初始历史值,单位nm²,不是把目标距离设成0.25 nm;目标由TO=1.0控制。KAPPA=50在这个距离CV例中的量纲为kJ·mol⁻¹·nm⁻⁴。
输入XYZ以nm为单位,运行时也显式指定--length-units nm。程序实际调用:
plumed driver --plumed plumed.dat --ixyz trajectory.xyz --length-units nm --dump-forces forces.xyz --dump-forces-fmt %24.16e
从终端生成同一组完整距离轨迹可以用:
python3 - <<'PY'
from pathlib import Path
distances = [2.0, 1.8, 1.9, 1.6, 1.7, 1.2, 1.4, 1.0, 0.9, 1.1, 1.0]
Path('trajectory.xyz').write_text(''.join(
f'2\n{i} 0 0\nH 0 0 0\nH {d:.16g} 0 0\n'
for i, d in enumerate(distances)))
PY
这里的两个H只是距离载体,没有设置化学相互作用势,不能把这些指定坐标当作H₂的真实动力学轨迹。
4 怎样读历史和偏置#
令rho=(d-TO)^2,不加噪声时rho_min记录从开始到当前的最小值。比历史最好值更靠近目标时,偏置为零;回退时,偏置为KAPPA/2*(rho-rho_min)^2。本例不启用NOISE和SEED随机分支。定义见官方ABMD说明。
自动初值条件下,距离从1.8回退到1.9 nm时,rho_min=0.64 nm²、偏置约0.7225 kJ/mol,距离CV上的力为−15.3 kJ·mol⁻¹·nm⁻¹。到达1.0 nm后历史最小值为零,越过到0.9或1.1 nm时力会指向目标的另一侧。
这不是普通的K/2*(d-TO)^2谐势。在距离变量上它包含距离偏差的四次项,力也依赖历史最小值。
5 为什么本篇使用个人入口#

本篇使用的原版2.10.1在到达新历史最小值时,会出现能量与force2归零,但上一帧输出力仍残留的情况。例如下一帧d=1.6 nm,原版距离CV输出仍为−15.3,按本例定义应为零;原子受力输出也显示同样残留,不能只看偏置能判断。
个人ABMD_LOCAL只在每个CV每帧开始时将输出力清零,之后历史、目标、能量和其他公式保持。两组本地实际结果的偏置能、CV力、两原子受力及virial与独立公式一致;公共原版没有被替换。上游对应版本见ABMD源码。
因此,复用本篇时要保留LOAD和ABMD_LOCAL两处写法;不能删掉LOAD后把名称改成ABMD,仍当作本篇相同流程。这里没有验证随机噪声、重启或长程MD采样,不把这组短例推广为那些功能的完整测试。
6 CV力与原子力分别在哪#
DUMPFORCES ARG=d得到cvforces.dat中的距离CV受力,原子受力由driver --dump-forces forces.xyz单独输出。两种输出的用途见官方DUMPFORCES说明与driver选项。
这个单距离例里,两个原子沿x方向受大小相等、方向相反的力。a.force2是距离CV力的平方,不是两个原子受力平方之和;后者在本例为前者的两倍。CSV把这几列分开保存。更一般的偏置链条可接着看从CV到原子力。