PLUMED VES基函数:多项式、三角与自定义
实际生成八类全局、组合与自定义基函数的数值、导数和均匀分布平均值,给出完整输入与绘图步骤。
阅读本篇目录
下载全部输入、实际输出、CSV和绘图程序(ZIP)。本篇先把VES基函数画出来,看清每个函数如何随CV变化,再考虑用于偏置展开。这里生成函数值和导数,不是在求材料自由能。
1 先读取和画图#
解压进入plumed-VES-basis:
bash read.sh
bash plot.sh
前者在analysis/汇总数值,后者生成figures/中的三张图;默认读取包内实际参考输出,不重新计算。

图中省略常数项f0,只展示f1–f4。幂函数和正交多项式形状不同;不能仅按相同编号认为它们代表相同函数。
2 一个完整的Legendre输入#
inputs/BF_LEGENDRE/plumed.dat:
bf: BF_LEGENDRE ORDER=5 MINIMUM=-1 MAXIMUM=1 DEBUG_INFO
VES_OUTPUT_BASISFUNCTIONS BASIS_FUNCTIONS=bf GRID_BINS=2000 FILE_VALUES=values.data FILE_DERIVS=derivs.data FORMAT_VALUES_DERIVS=%24.16e
ORDER=5包括0至5阶,共6个函数;MINIMUM/MAXIMUM指定CV区间。GRID_BINS=2000划分2000个区间,非周期情形包含两端,共2001行。DEBUG_INFO在日志中列出基函数说明;它不改变物理模型。
单独运行时,在已分配的计算资源中执行:
source environment.sh
cd inputs/BF_LEGENDRE
plumed driver --plumed plumed.dat --ixyz configuration.xyz
head -8 values.data
head -8 derivs.data
每行第一列是CV值,后面依次是f0、f1……;导数文件对应df0/ds、df1/ds……。例如本例Legendre的f2=(3s²−1)/2,在s=0处为−0.5,导数为0。
3 如何换成其他函数#
保留上一节第二行输出命令,只替换第一行:
bf: BF_CHEBYSHEV ORDER=5 MINIMUM=-1 MAXIMUM=1 DEBUG_INFO
bf: BF_POWERS ORDER=5 MINIMUM=-1 MAXIMUM=1 DEBUG_INFO
bf: BF_COSINE ORDER=5 MINIMUM=-1 MAXIMUM=1 DEBUG_INFO
bf: BF_SINE ORDER=5 MINIMUM=-1 MAXIMUM=1 DEBUG_INFO
bf: BF_FOURIER ORDER=5 MINIMUM=-1 MAXIMUM=1 DEBUG_INFO
Chebyshev、Legendre和Powers各6个函数。Cosine/Sine各6个,Fourier则包含常数与5对正弦余弦,共11个。三角基函数的周期必须与实际CV相容;本例周期为2,Fourier顺序为1、cos(πs)、sin(πs)、cos(2πs)、sin(2πs)……。
周期网格不重复右端点,因此这几组三角输出是2000行:−1、−0.999……0.999,而不是遗漏数据。
4 自定义函数与组合#
自定义示例的完整第一行如下,输出命令仍沿用第二节:
bf: BF_CUSTOM MINIMUM=-1 MAXIMUM=1 FUNC1=x FUNC2=x*x FUNC3=x*x*x FUNC4=exp(-x*x) DEBUG_INFO CHECK_NAN_INF
这里常数f0由程序提供,加上4个自定义函数,共5个。在本例对称区间上x=s;修改区间后应先查看输出和内部变量映射,避免把表达式中的x直接当作任意单位的原始CV。
组合余弦与正弦的完整输入:
c: BF_COSINE ORDER=2 MINIMUM=-1 MAXIMUM=1
s: BF_SINE ORDER=2 MINIMUM=-1 MAXIMUM=1
bf: BF_COMBINED BASIS_FUNCTIONS=c,s DEBUG_INFO
VES_OUTPUT_BASISFUNCTIONS BASIS_FUNCTIONS=bf GRID_BINS=2000 FILE_VALUES=values.data FILE_DERIVS=derivs.data FORMAT_VALUES_DERIVS=%24.16e
常数项合并为一个,所以不是6个函数,而是5个:1、cos(πs)、cos(2πs)、sin(πs)、sin(2πs)。与Fourier相应低阶子空间相同,但列顺序不同,分析脚本必须对应列号。组合规则见官方说明。
5 平均值与导数怎么看#
head -12 reference-results/BF_POWERS/bf.targetdist-averages.data
cat analysis/PLUMED-VES-basis-validation.csv
bf.targetdist-averages.data给出本例默认均匀目标分布下的基函数平均,不是轨迹采样平均。x²的参考平均为1/3,原生文件打印约0.333334,差异来自数值积分与打印精度。修改目标分布后,这些平均也会改变。

八组全局/自定义/组合函数的实际值与独立表达式吻合;局域基函数另见Gaussian、B样条与小波。更高阶并不自动更准确,实际使用还要考虑采样覆盖和系数优化的稳定性。
环境与重新运行#
本例使用集群PLUMED 2.10.1的VES模块;该入口以Intel oneAPI C++ 2024.2、Intel MPI 2021.13、MKL 2024.2顺序库和GSL 2.8编译,使用C++17。它随cp2k/2026.2-8173m模块提供,但这几个例子只调用PLUMED driver,不运行CP2K。
在资料包顶层重新计算全部11类基函数:
sbatch run.slurm
这份CPU提交模板按集群56核整节点规则申请资源,程序实际最多并行4个单线程driver。计算完成后:
bash read.sh work-new analysis-new
bash plot.sh work-new
输入复制到新work-new/,同名目录存在时停止,原始参考输出保留。configuration.xyz只有一帧两个H原子,用来让driver正常执行和退出;图中横轴是基函数的无量纲CV网格,不是H—H距离或分子动力学轨迹。正式材料模拟还需要定义实际CV、偏置、目标分布和优化步骤。