PLUMED外部偏置势:读取网格、缩放与受力
实际运行EXTERNAL的一维势、负SCALE和三种精度的二维耦合网格,给出势表生成、driver命令、原子受力与网格误差图。
阅读本篇目录
下载五组输入、原生结果、三张CSV、图片与脚本(ZIP)。EXTERNAL读取您提供的势能表,根据当前集体变量的位置插值得到偏置和受力,适用于已有目标势或准备好的自由能偏置表。
本篇使用cp2k/2026.2-8173m附带的独立PLUMED2.10.1 driver,构建为Intel oneAPI2024.2、Intel MPI2021.13。五组小后处理均在鸢算科技集群实际运行。输入是6帧三点构造坐标,没有真实原子间相互作用,没有运行MD,也没有从这些帧测量自由能。
1 先读取和画图#
进入解压后的plumed-external-grid:
bash read.sh
bash plot.sh
cat analysis/PLUMED-external-grid-convergence.csv
head analysis/PLUMED-external-bias.csv
head analysis/PLUMED-external-forces.csv
三张CSV分别保存网格误差、每帧偏置,以及三点的三维坐标和受力。读取、画图不启动科学计算。
2 一维势表怎样写#
本例对点1–2的距离d1定义:
U(d1) = 2*(d1-0.9)^2 + 0.3 kJ/mol
dU/dd1 = 4*(d1-0.9) kJ/(mol·nm)
在0–2 nm间每隔0.1 nm采样一次,共21个点。bias.grid开头为:
#! FIELDS d1 ext.bias der_d1
#! SET min_d1 0
#! SET max_d1 2
#! SET nbins_d1 21
#! SET periodic_d1 false
0.0 1.92 -3.6
0.1 1.58 -3.2
0.2 1.28 -2.8
0.3 1.02 -2.4
0.4 0.80 -2.0
这只是开头,完整文件一直写到2.0。d1要对应PLUMED的变量标签,势能列名ext.bias对应本篇的ext: EXTERNAL。der_d1填写势对d1的正导数,不是原子受力;原子受力还要加负号并通过距离对坐标的导数传递。
**当前版本读取非周期网格文件时,nbins_d1写包含两个端点的点数21,不写20个间隔。**采样坐标、端点和这个数必须一致,否则程序即使完成,也可能读到错误的势。二维网格每个方向同理。当前Grid读取实现采用这个文件约定。
用随包脚本生成完整的一维势表:
python3 make-grid.py my-bias.grid
head my-bias.grid
脚本拒绝覆盖已有文件,生成内容与第一组的势表一致。要换势函数,修改脚本中的u和du,两者必须对应,并确认单位。
3 完整PLUMED输入与运行命令#
inputs/one-dimensional-point21/plumed.dat:
UNITS LENGTH=nm TIME=fs ENERGY=kj/mol
d1: DISTANCE ATOMS=1,2 NOPBC
ext: EXTERNAL ARG=d1 FILE=bias.grid SCALE=1.0
PRINT ARG=d1,ext.bias FILE=COLVAR STRIDE=1 FMT=%24.16e
第一帧trajectory.xyz:
3
10 10 10
X 0 0 0
X 0.33 0.1 0.1
X 0.2 1.52 0.15
位置单位nm,XYZ第二行是driver使用的盒子,X仅代表构造点。NOPBC不使用最小镜像;本篇一维偏置只涉及前两个点,第3点在这一组的偏置受力为0。
手动运行第一组:
bash prepare.sh
source /etc/profile
source environment.sh
cd work-new/one-dimensional-point21
plumed driver --plumed plumed.dat --ixyz trajectory.xyz \
--length-units nm --dump-forces forces.xyz
cat COLVAR
head forces.xyz
prepare.sh准备新目录,已有work-new时拒绝覆盖。若要一次运行五组,请在新解压目录中改用:
bash prepare.sh
bash run.sh
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
两种运行方式二选一,避免把同一组重复写入已有输出。driver只对现有帧求偏置与受力,不积分动力学;COLVAR的1000 fs时间间隔是构造帧标记,不是本例已经模拟了这么长时间。
4 SCALE同时缩放能量和力#
第二组保持同一势表,把输入改为:
ext: EXTERNAL ARG=d1 FILE=bias.grid SCALE=-0.5
输出偏置和受力都乘以-0.5。负号会反转偏置方向,可以用于有明确目的的势表反号,但不能据此认为反号后的势一定适合稳定MD。本例只做给定帧的后处理。

第一帧距离d1约0.3590264614 nm,SCALE=1偏置为0.885304738887 kJ/mol,第1点Fx约-1.9889483023 kJ/(mol·nm);SCALE=-0.5时分别为-0.442652369443和+0.9944741512。六帧一维原生能量和受力均与解析函数一致到浮点数精度。势中的0.3是能量偏移,在这个一维例子中不改变受力。
5 二维势表:ARG与列顺序必须对应#
第三至第五组同时使用两个距离:
UNITS LENGTH=nm TIME=fs ENERGY=kj/mol
d1: DISTANCE ATOMS=1,2 NOPBC
d2: DISTANCE ATOMS=1,3 NOPBC
ext: EXTERNAL ARG=d1,d2 FILE=bias.grid SCALE=1.0
PRINT ARG=d1,d2,ext.bias FILE=COLVAR STRIDE=1 FMT=%24.16e
定义的连续目标势为:
U = 2*(d1-0.8)^2 + 3*(d2-1.0)^2 + (d1-0.8)*(d2-1.0)
der_d1 = 4*(d1-0.8) + (d2-1.0)
der_d2 = 6*(d2-1.0) + (d1-0.8)
势表列名为:
#! FIELDS d1 d2 ext.bias der_d1 der_d2
ARG=d1,d2与文件头的参数顺序一致。两个方向各自设置min、max、nbins和periodic;本例数据中d1变化最快,一轮d1之后再增加d2。全部采样坐标都留在势表范围内。
6 表格插值精度:能量和受力分开看#
当前EXTERNAL默认对表格插值。它得到的是表格插值势,不保证任意二维连续函数在有限网格上精确重建。因此我们实际运行了三种网格,分别比较六个采样位置的能量和全部原子受力:
| 每维点数 | 间距/nm | 相对定义势的最大能量误差/kJ·mol⁻¹ | 最大力分量误差/kJ·mol⁻¹·nm⁻¹ |
|---|---|---|---|
| 21 | 0.1 | 2.7755e-4 | 0.04159 |
| 41 | 0.05 | 9.8702e-5 | 0.007125 |
| 81 | 0.025 | 1.0196e-5 | 0.006157 |

这里细网格的能量更接近定义势,受力误差的下降幅度却不同。换自己的势表时,应增加采样密度并分别检查能量、梯度、边界与实际采样范围,不要只看一张平滑的势能图。
随包读取脚本还独立计算表格插值及其梯度,并用有限差分再核对梯度;五组共270个原子受力分量与实际插值势一致。这说明这些偏置确实传回了原子,同时保留了上表的有限网格误差,不把二维插值当成连续目标势的精确值。
本篇没有演示NOSPLINE或稀疏网格SPARSE;不要将未插值取格点的方法直接替代需要平滑受力的设置。参数入口见官方EXTERNAL说明。如果您的表来自自由能结果,应先确认符号、温度、参考零点与集体变量定义;本篇的人工势表本身不构成自由能计算。