PLUMED专题

PLUMED ABMD棘轮偏置与个人兼容入口

用11帧距离轨迹演示ABMD的历史最小值、MIN参数和受力,区分原版受力残留与个人插件的实际结果。

更新于 2026-11-15约 5 分钟阅读按任务与环境选择适用配置
阅读本篇目录

下载完整输入、实际输出、个人插件源码、数据和图片(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

自动初值和指定MIN条件下的实际历史最小值与偏置能

两组各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到原子力。

需要根据你的体系选择资源?联系讨论计算需求。实际可用软件与权限,以当前账户和运行环境为准。

查看配图

放大后可滚动查看细节,按 Esc 关闭。

100%查看原图 ↗