PLUMED专题

PLUMED VES基函数:多项式、三角与自定义

实际生成八类全局、组合与自定义基函数的数值、导数和均匀分布平均值,给出完整输入与绘图步骤。

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

下载全部输入、实际输出、CSV和绘图程序(ZIP)。本篇先把VES基函数画出来,看清每个函数如何随CV变化,再考虑用于偏置展开。这里生成函数值和导数,不是在求材料自由能。

1 先读取和画图#

解压进入plumed-VES-basis:

bash read.sh
bash plot.sh

前者在analysis/汇总数值,后者生成figures/中的三张图;默认读取包内实际参考输出,不重新计算。

同一CV区间上幂函数、Chebyshev、Legendre与Fourier基函数的实际输出

图中省略常数项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,差异来自数值积分与打印精度。修改目标分布后,这些平均也会改变。

Legendre和Daubechies基函数原生导数与从函数值独立差分得到的导数

八组全局/自定义/组合函数的实际值与独立表达式吻合;局域基函数另见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、偏置、目标分布和优化步骤。

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

查看配图

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

100%查看原图 ↗