PLUMED函数后处理:Bessel值与平滑区间权重
实际运行BESSEL及标量和向量入口、BETWEEN向量区间权重,给出读取、driver命令和偏置受力例子,说明缩放、输入秩与导数支持。
阅读本篇目录
下载三个真实后处理例子、输入、CSV、图片与脚本(ZIP)。本篇使用CP2K2026.2 CPU环境附带的独立PLUMED2.10.1 driver,介绍两个数值处理工具:Bessel函数值,以及落入指定区间的平滑权重。
这里处理的是人为构造的坐标帧和数值向量,不运行分子动力学,不把这些点解释成真实分子轨迹、概率或自由能曲线。
1 先读取和画图#
进入解压后的plumed-bessel-between:
bash read.sh
bash plot.sh
cat analysis/PLUMED-Bessel-Between-scalar.csv
cat analysis/PLUMED-Bessel-Between-vectors.csv
两条脚本只读已有结果。三组原版工具操作都在鸢算科技集群实际运行:9帧两点坐标、9项常数向量,以及7项较大参数向量,均用普通账号、1线程完成。
2 Bessel:先弄清输出是哪一种函数#
在这一版本中,ORDER=0的实际输出为:
exp(-abs(x)) * I0(x)
其中I0是零阶修正Bessel函数,前面有指数缩放。**不要把输出直接按未缩放的I0或普通J0使用。**例如:
| 参数x | 本例原生输出 |
|---|---|
| 0 | 1.0000000000 |
| 0.5 | 0.6450352704 |
| 1 | 0.4657596076 |
| 2 | 0.3085083226 |
我们用函数的独立积分定义核对所有标量和向量值,也包括abs(x)>8的分段范围。图上每个点均来自实际输出。

向量输入的完整例子在inputs/vector-aliases/plumed.dat:
x: CONSTANT VALUES=-2,-1.5,-1,-0.5,0,0.5,1,1.5,2
b: BESSEL ARG=x ORDER=0
bv: BESSEL_VECTOR ARG=x ORDER=0
g: BETWEEN ARG=x LOWER=-0.5 UPPER=0.5 SMEAR=0.2
gv: BETWEEN_VECTOR ARG=x LOWER=-0.5 UPPER=0.5 SMEAR=0.2
DUMPVECTOR ARG=b,bv,g,gv FILE=vectors.dat FMT=%24.16e
BESSEL根据输入类型选择对应入口;本例显式BESSEL_VECTOR的结果与它一致。标量入口是BESSEL_SCALAR。当前仅支持零阶,并且当前构建没有实现Bessel偏置所需的导数,因此本篇只读取函数值,不将Bessel接到RESTRAINT等需要导数的偏置上。官方实现可用于了解该版本的分段求值和导数声明。
3 BETWEEN:得到平滑区间权重#
给定区间上下界后,BETWEEN在区间内部接近1,外部接近0,边界附近平滑过渡。它不是一次判断后只输出0或1的硬筛选。
本例当前构建的该功能接受向量,没有对应的标量入口。要处理单个距离,可先把距离组成长度为1的向量,再把结果取回一个标量:
UNITS LENGTH=nm TIME=fs ENERGY=kj/mol
d: DISTANCE ATOMS=1,2 NOPBC
b: BESSEL_SCALAR ARG=d ORDER=0
v: CONCATENATE ARG=d
gv: BETWEEN_VECTOR ARG=v LOWER=0.5 UPPER=1.5 SMEAR=0.2
g: MEAN ARG=gv PERIODIC=NO
rg: RESTRAINT ARG=g AT=0 KAPPA=1
PRINT ARG=d,b,g,rg.bias FILE=COLVAR FMT=%24.16e
这就是inputs/scalar-final/plumed.dat。MEAN处理本例只有一项的向量,得到的数仍是这一项权重;如果改成多项向量,平均值的含义就不同了,不能再当成单个距离的权重。
区间为0.5–1.5 nm,SMEAR=0.2按区间宽度设置平滑宽度,本例实际为0.2 nm。距离0.5或1.5 nm时权重约0.5,0.9或1.1 nm时约0.975900;这个有限宽度区间的最高权重也不必严格等于1。官方BETWEEN说明给出了相关参数入口。
这里Bessel接收距离的nm数值,相当于选1 nm作为参考长度后的无量纲参数,只用于数学函数操作。实际应用要先根据问题明确无量纲化的参考尺度。
4 运行三个后处理例子#
bash prepare.sh
bash run.sh
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
prepare.sh新建work-new,已有目录时拒绝覆盖;run.sh加载匹配环境后依次运行三个小后处理例子。没有新建原子动力学任务,也没有安装或修改共享软件。当前构建环境为Intel oneAPI2024.2、Intel MPI2021.13。
想手动运行其中一个例子,可在准备后选择下面的方法,避免同时重复执行run.sh:
source /etc/profile
source environment.sh
cd work-new/scalar-final
plumed driver --plumed plumed.dat --ixyz trajectory.xyz \
--length-units nm --dump-forces forces.xyz
cat COLVAR
head forces.xyz
PLUMED driver读取XYZ时需要盒子信息,本例把10 10 10写在每帧第二行;DISTANCE NOPBC不采用最小镜像。示例两个点之间没有真实相互作用势,forces.xyz只保存区间权重偏置的受力。
处理常数向量无需坐标:
cd ../vector-aliases
plumed driver --plumed plumed.dat --noatoms
cat vectors.dat
输出parameter是向量元素索引,多个元素属于同一个时刻,不是多帧时间数据。坐标例子的COLVAR时间列则是driver为构造帧附加的间隔,本例未据此计算动力学物性。
5 看偏置和受力#
本例设置RESTRAINT ARG=g AT=0 KAPPA=1,所以偏置为g*g/2 kJ/mol。我们对平滑区间积分求导,再按链式法则计算原子受力,与原版工具的9帧输出逐一比较。

例如距离0.5 nm时,第一个点的x方向受力约+0.9973514 kJ/(mol·nm),第二个点大小相同、方向相反。区间另一侧受力方向反转;这来自偏置对距离的导数,不能按“权重越大、力越大”判断。Bessel只出现在输出中,没有为这些受力作贡献。
本篇没有把ORDER>0、Bessel偏置导数、标量BETWEEN直接调用或其他PLUMED版本当作已支持的功能。换环境时先检查版本与实际入口,再复用输入。